Status: [LIVE]

Endpoints found:
https://souyi.net.cn/api/v1/mcp
https://souyi.net.cn/api/v1/mcp`

Source: https://github.com/sukyboor/aimall-mcp

# aimall-mcp

Official MCP server for **[AIMALL / 搜蚁智选](https://souyi.net.cn)** — 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:

```json
{
  "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

```bash
curl -O https://souyi.net.cn/mcp/server.py   # or clone this repo
python3 server.py                            # Python 3.9+, stdlib only
```

```json
{
  "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