Skip to content

MCP

Streamable HTTP tools for agents — same product jobs as /api/v3 REST

Last updated:

ConnectLink copied!

Endpoint: https://silphcoanalytics.xyz/api/v3/mcp/. Send Authorization: Bearer with a dashboard API key (sk_live_...) or a signed-in user JWT. A free key is enough; no key returns HTTP 401. There is no anonymous MCP playground.

Clients need the Streamable HTTP transport, custom request headers, and redirect-following — the bare path 307s to the trailing-slash URL. After initialize, SDK clients carry the mcp-session-id header automatically.

Keyless quote is REST only: GET /api/v3/quote?q=42382. Load the skill first: /skill-api.md. Full getting-started copy: /docs/reference/mcp.md.

ToolsLink copied!

Ten public product jobs — the same jobs as the site and REST:

  • search — card lookup: q for name/id search, or an ids list for batch resolve. Ambiguous names return candidates (never silent top-1).
  • quote — multi-id card-hero quote (ids list, optional shared grade/finish/edition): Midprice when usable, else Last, else Ask.
  • get_prices / get_sales / get_listings — warehouse prices, recent sales, and live asks; all take ids lists.
  • batch_grade_ladder / compare_set_finish / pin_cohort / get_cohort / rank_set_sales — set and grade cohort jobs.

execute_sql is not available on public MCP. Tool failures return result.isError: true with a JSON-RPC 200 — check the envelope, not just the status code.

Public MCP version 1.1.0 — exactly these ten tools, no others on dashboard keys.

Agent patternsLink copied!

Identity, then finish. search(q="Nidoking") resolves the card; pass finish="reverse_holo" on quote, get_listings, or batch_grade_ladder. Do not put finish words in search.q.

δ-era commons (ex11+ex14+ex15). batch_grade_ladder(era=delta_species, rarity=Common, finish=reverse_holo) — or pin_cohort → batch_grade_ladder(cohort_handle=…).

Gem-rate / pop questions. Use batch_grade_ladder on the cohort, or pin first — there is no separate gem-rank public tool.

Batch firstLink copied!

quote, get_prices, get_sales, and get_listings take ids lists; search takes q or an ids list — one call, same cost as the ids inside it. Bound get_prices with limit/since; the default returns each id's full series (hundreds of KB for a small list).

Client configLink copied!

{
  "mcpServers": {
    "silphco": {
      "server_url": "https://silphcoanalytics.xyz/api/v3/mcp/",
      "headers": {
        "Authorization": "Bearer ${SILPH_API_KEY}"
      }
    }
  }
}

Need REST instead? Getting started → For agents. Full handshake curl walkthrough: /docs/reference/mcp.md.