English Français العربية

AIMALL (搜蚁智选)

السجل الرسمي البحث والويب

Pay-per-use API marketplace for AI agents: LLMs, image, TTS, search. Free trial, x402.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
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.>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "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.>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. aimall-mcp
  2. Two ways to connect
  3. Tools
  4. Self-serve onboarding (the interesting part)
  5. Pricing & payment
  6. Machine-readable surfaces
  7. Quick check that it works
  8. x402 payment (optional)
  9. Links
  10. License

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

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

ToolAuthWhat it does
list_assetsnoneList available models/tools with asset_id and unit price
ai_estimatenoneEstimate a call's cost in USD without charging — a budget gate before you commit
ai_requestkeyCall an asset; returns result, order_id, cost_usd, balance_remaining, latency_ms
bootstrap_accountnoneSelf-register and create an agent; returns a ready-to-use ak_... key
get_onboardingnoneOnboarding 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_estimate is 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:

FilePurpose
https://souyi.net.cn/llms.txtOverview for LLMs
https://souyi.net.cn/llms-full.txtFull catalogue, endpoints, pricing, curl examples
https://souyi.net.cn/openapi.jsonOpenAPI 3 spec
https://souyi.net.cn/.well-known/agent.jsonAgent card (protocols, auth, capabilities)
SKILL.mdCapability 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.md

Quick 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.

License

MIT — see LICENSE.

الأسئلة الشائعة

ما هو AIMALL (搜蚁智选)؟

Pay-per-use API marketplace for AI agents: LLMs, image, TTS, search. Free trial, x402.

كيف أثبّت AIMALL (搜蚁智选)؟

يعمل كخادم بعيد. في 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.>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج AIMALL (搜蚁智选) إلى مفتاح API؟

نعم. يتطلب X-API-Key، وتضبطها في إعداداته.

هل AIMALL (搜蚁智选) مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون AIMALL (搜蚁智选)؟

ينشره sukyboor. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.