Skip to content
Ctrl/⌘ K

MCP

MCP model catalog tool

Discover BYOK providers, models, capabilities, pricing, and setup links.

Overview

List the public BYOK provider/model catalog, capabilities, verified pricing, supported key scopes, and provider-key setup URL.

Use the typed search tools for web retrieval. Use list_models before BYOK query-builder or agent calls, and configure a provider key at the returned setup_url when requested. When a tool error's structured content includes error.validation, correct every listed RFC 6901 issue before retrying and never repeat an unchanged rejected input.

Input schema

MCP model catalog tool input

Output schema

Returns structured JSON from the shared public API service.

MCP model catalog tool output fields
Name
providers
Required
Yes
Type
AgentProviderOption[]
Description
Git-owned provider choices and their external key-creation links.
Name
models
Required
Yes
Type
PublicAgentModelOption[]
Description
Git-owned provider/model allowlist joined with verified pricing.
Name
pricing_snapshot
Required
Yes
Type
AgentPricingSnapshot
Description
Provenance and freshness of the displayed provider prices.
Name
setup_url
Required
Yes
Type
string
Description
Signed-in Yep route for storing the selected provider credential.

Tool errors

Tool execution failures set isError to true. When error.validation is present, correct every RFC 6901 issue before retrying and do not repeat unchanged input.

Request json 
{
  "error": {
    "code": "invalid_request",
    "reason": "malformed_request",
    "message": "invalid request: request body violates the public contract",
    "recovery": null,
    "agent_session_id": null,
    "validation": {
      "contract": "SearchPostRequest",
      "issues": [
        {
          "code": "required",
          "path": "/query",
          "suggestion": "Add the required `query` field."
        }
      ],
      "truncated": false
    }
  },
  "request_id": "00000000-0000-0000-0000-000000000000"
}

Behavior

This tool is read-only, non-destructive, and idempotent.

Commands