Developers

The SuliHuli EV catalog for code and AI agents: an MCP server, a JSON API and Markdown pages. Open without a key; a free key raises the limits and opens the whole catalog.

Get a free key

Already have an account? Sign in to your account to create more keys, rename or revoke them and see usage.

What you can call

Door	Address	What it gives
MCP server	https://sulihuli.com/api/mcp	search_models, get_model, compare_models, list_categories, get_category_ranking. Streamable HTTP, JSON-RPC over POST, no session.
JSON API	https://sulihuli.com/api/v1/models	The catalog in pages; one model at /api/v1/models/<slug>; comparison at /api/v1/compare/<a>-vs-<b>; rankings at /api/v1/categories.
Markdown	https://sulihuli.com/m/<slug>.md	Every model, ranking and guide page as Markdown: add .md, or send Accept: text/markdown to the page URL.
CLI	npx sulihuli	Search, one model, compare and rankings from the terminal, with --json.

Every figure comes with its source link and date, and with its status: verified, or collected and not yet verified. Photos come with their credit. Details for agents: methodology, llms.txt.

Limits

	Without a key	With a free key
Requests	60 per minute per address	600 per minute
Model lists	pages of 50, without per-value source chains	pages of up to 500, with source chains
One model, comparison, Markdown, MCP	open, with sources	open, with sources
Terms	Terms of Use	API Terms, accepted when you get the key

Over the limit, the answer is 429 with Retry-After. A key that is unknown or revoked is a 401 - drop it to fall back to the open limits.

Using the key

Send it in the Authorization: Bearer header (or X-API-Key) on any API, Markdown or MCP request.

curl -H "Authorization: Bearer shk_..." "https://sulihuli.com/api/v1/models?per_page=500"

An MCP client that takes a URL and headers:

{
  "mcpServers": {
    "sulihuli": {
      "url": "https://sulihuli.com/api/mcp",
      "headers": {
        "Authorization": "Bearer shk_..."
      }
    }
  }
}

Keep the key secret: not in public code, not in a browser page others can open.
Show "Data: SuliHuli" with a link to the model page wherever people see the data, and keep each figure's source and status.
Do not copy the catalog, resell it or train models on it.