English Français العربية

AIMALL (搜蚁智选)

Official registry Search and web

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

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

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 configuration (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.>"
            }
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

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

Frequently asked questions

What is AIMALL (搜蚁智选)?

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

How do I install AIMALL (搜蚁智选)?

It runs as a remote server. In 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.>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does AIMALL (搜蚁智选) need an API key?

Yes. It expects X-API-Key, which you set in its configuration.

Is AIMALL (搜蚁智选) open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains AIMALL (搜蚁智选)?

It is published by sukyboor. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.