Agent Router Pro
Get Started

Tool Catalog

Search tool (MCP + REST)

One StepFun-backed search tool, exposed through REST and MCP streamable HTTP. Copy the parameters below and connect from your favorite client.

API DocsMCP Guide
searchcategory: webversion 1.0
Tool details
StepFun search → ranked snippets. Auth via API key or signed-in session. MCP surface follows JSON-RPC 2.0 over streamable HTTP.

REST (API)

https://pro.ixiqin.com/v1/search

  • POST body: query (required), n (1-20), category (optional)
  • Auth: Authorization: Bearer sk-ar-… or x-api-key
  • Billing: fixed $0.01/call (charged after upstream 2xx)

MCP (Streamable HTTP)

https://pro.ixiqin.com/v1/mcp/search

  • Headers: Authorization, Content-Type, MCP-Protocol-Version
  • tools/list returns the single tool: search
  • Args: query required; top_n/limit 1-20; category optional

Input validation

  • query: non-empty string
  • top_n / limit: integers 1–20, top_n takes precedence
  • category: optional string, forwarded to StepFun

Output shape

  • content: list of text items with url / score / category / rank metadata
  • meta: took_ms、total、upstream_request_id
  • Streaming: progress events followed by final result

Integration paths

For API use, follow the docs. For MCP, paste the parameters below into your client.

Claude Code
Add the HTTP server via claude mcp add.
claude mcp add --transport http agentrouter-search https://pro.ixiqin.com/v1/mcp/search \
  --header "Authorization: Bearer sk-ar-..." \
  --header "MCP-Protocol-Version: 2025-06-18"
  • Transport: streamable HTTP
  • Tool: search
  • Headers: Authorization, MCP-Protocol-Version
Codex
Declare the streamable HTTP server in ~/.codex/config.toml.
[mcp_servers.agentrouter-search]
url = "https://pro.ixiqin.com/v1/mcp/search"
bearer_token_env_var = "AGENTROUTER_API_KEY"
http_headers = { "MCP-Protocol-Version" = "2025-06-18" }

# Then export your key before launching Codex:
# export AGENTROUTER_API_KEY=sk-ar-...
  • Works for Codex CLI and IDE extensions
  • Store the API key in env vars to avoid plaintext
Standard MCP client
Send JSON-RPC 2.0 (tools/list, tools/call) over HTTP.
POST https://pro.ixiqin.com/v1/mcp/search
Content-Type: application/json
Authorization: Bearer sk-ar-...
Accept: application/json

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "search",
    "arguments": {
      "query": "latest Agent Router docs",
      "top_n": 5
    }
  }
}
  • Set Accept to text/event-stream to receive streaming progress
  • Keep REST /v1/search as a fallback if you prefer