AIMALL (搜蚁智选)
Pay-per-use API marketplace for AI agents: LLMs, image, TTS, search. Free trial, x402.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http aimall 'https://souyi.net.cn/api/v1/mcp' --header 'X-API-Key: <AIMALL agent API key (ak_...). Not required for list_assets / ai_estimate / get_onboarding; required for ai_request. Obtain it by calling the bootstrap_account tool.>'{
"mcpServers": {
"aimall": {
"type": "http",
"url": "https://souyi.net.cn/api/v1/mcp",
"headers": {
"X-API-Key": "<AIMALL agent API key (ak_...). Not required for list_assets / ai_estimate / get_onboarding; required for ai_request. Obtain it by calling the bootstrap_account tool.>"
}
}
}
}Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
aimall-mcp
Official MCP server for AIMALL / 搜蚁智选 — a pay-per-use API marketplace built for autonomous AI agents.
An agent can discover the catalogue, price a call, register itself, get an API key, call hosted models and tools, and pay from its balance — without a human in the loop.
Agent → list_assets → ai_estimate → bootstrap_account → ai_request → (billed, order_id + balance returned)Two ways to connect
1. Remote (recommended) — no install
Streamable HTTP endpoint:
{
"mcpServers": {
"aimall": {
"url": "https://souyi.net.cn/api/v1/mcp",
"headers": { "X-API-Key": "ak_..." }
}
}
}Claude Desktop / Cursor / Claude Code / any MCP client: point it at https://souyi.net.cn/api/v1/mcp with an X-API-Key header.
2. Local stdio — zero dependencies
curl -O https://souyi.net.cn/mcp/server.py # or clone this repo
python3 server.py # Python 3.9+, stdlib only{
"mcpServers": {
"aimall": {
"command": "python3",
"args": ["/absolute/path/to/server.py"],
"env": { "AIMALL_API_KEY": "ak_...", "AIMALL_BASE_URL": "https://souyi.net.cn" }
}
}
}Tools
| Tool | Auth | What it does |
|---|---|---|
list_assets | none | List available models/tools with asset_id and unit price |
ai_estimate | none | Estimate a call's cost in USD without charging — a budget gate before you commit |
ai_request | key | Call an asset; returns result, order_id, cost_usd, balance_remaining, latency_ms |
bootstrap_account | none | Self-register and create an agent; returns a ready-to-use ak_... key |
get_onboarding | none | Onboarding steps + links to machine-readable docs |
Only ai_request requires a key. list_assets, ai_estimate and get_onboarding are open so an agent can evaluate the marketplace before spending anything.
Self-serve onboarding (the interesting part)
An agent with no account can bootstrap itself in one tool call:
{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"bootstrap_account","arguments":{"email":"agent@example.com","password":"secret123","username":"my-agent"}}}Response:
账号已创建。
API Key: ak_xxxxxxxxxxxxxxxx
当前余额: $1.00（注册赠送，可直接调用）No email confirmation, no dashboard, no human. Put that key in X-API-Key and start calling.
Pricing & payment
- Registration grants $1 free trial; email verification adds $4.
- Billing is per call or per token, deducted from the agent's balance.
ai_estimateis free — price it before you run it.- Top-ups: x402 (USDC on Base) for agent-autonomous payment, plus standard top-up.
Machine-readable surfaces
Agents and crawlers should use these instead of the HTML site:
| File | Purpose |
|---|---|
https://souyi.net.cn/llms.txt | Overview for LLMs |
https://souyi.net.cn/llms-full.txt | Full catalogue, endpoints, pricing, curl examples |
https://souyi.net.cn/openapi.json | OpenAPI 3 spec |
https://souyi.net.cn/.well-known/agent.json | Agent card (protocols, auth, capabilities) |
SKILL.md | Capability package — install so an agent knows how to use AIMALL |
SKILL.md
SKILL.md is the highest-leverage file here. Dropping it into an agent's skills directory doesn't just tell the agent AIMALL exists — it teaches the actual call sequence and cost discipline.
curl -O https://souyi.net.cn/SKILL.mdQuick check that it works
curl -s -X POST https://souyi.net.cn/api/v1/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_assets","arguments":{}}}'Supports MCP protocol versions 2025-06-18, 2025-03-26, 2024-11-05 with negotiation.
x402 payment (optional)
No wallet top-up needed: call with no API key → server returns a 402 quote →
pay exactly that Base USDC → resend with the tx hash. Zero platform fee.
Links
- Platform: https://souyi.net.cn
- For agents: https://souyi.net.cn/for-agents.html
- Docs: https://souyi.net.cn/llms-full.txt
License
MIT — see LICENSE.
Questions fréquentes
Qu'est-ce que AIMALL (搜蚁智选) ?
Pay-per-use API marketplace for AI agents: LLMs, image, TTS, search. Free trial, x402.
Comment installer AIMALL (搜蚁智选) ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http aimall 'https://souyi.net.cn/api/v1/mcp' --header 'X-API-Key: <AIMALL agent API key (ak_...). Not required for list_assets / ai_estimate / get_onboarding; required for ai_request. Obtain it by calling the bootstrap_account tool.>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour AIMALL (搜蚁智选) ?
Oui. Il attend X-API-Key, à renseigner dans sa configuration.
AIMALL (搜蚁智选) est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient AIMALL (搜蚁智选) ?
Il est publié par sukyboor. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.