MyMCPTools

Search the MyMCPTools catalog of Model Context Protocol servers. Filter by free-text query, category slug, integration slug (claude-desktop, cursor, vs-code, ...), install type, or official status. Set only_verified to restrict to servers that answered a live MCP handshake on the most recent probe. Results carry the live verdict for each server.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Free-text query matched against name, description, author and category.",
      "type": "string"
    },
    "category": {
      "description": "Category slug, e.g. 'database'. See list_categories.",
      "type": "string"
    },
    "integration": {
      "description": "Integration slug, e.g. 'claude-desktop' or 'cursor'.",
      "type": "string"
    },
    "install_type": {
      "description": "Restrict to one install mechanism.",
      "type": "string",
      "enum": [
        "npm",
        "pip",
        "binary",
        "docker",
        "source",
        "remote"
      ]
    },
    "official": {
      "description": "Only first-party/official servers.",
      "type": "boolean"
    },
    "only_verified": {
      "description": "Only servers whose latest probe verdict is GOOD or WARN.",
      "type": "boolean"
    },
    "limit": {
      "description": "Max results (default 10, max 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Full catalog entry for one MCP server by slug: description, author, install command, repo, supported clients, current probe verdict, static repo-freshness signal for local servers, and related servers in the same categories.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Catalog slug, e.g. 'filesystem' or 'github'."
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Current live-probe status for one server: verdict (GOOD / WARN / AUTH_REQUIRED / DOWN / UNPROBEABLE), exposed tool count, handshake latency, negotiated protocol version, remote endpoint, and when it was last seen healthy. Omit the slug to get the catalog-wide verdict summary instead.

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "Catalog slug. Omit for the catalog-wide verdict rollup.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Trailing probe history for one server plus a daily uptime sparkline — the reliability signal behind the badge on mymcptools.com. Returns per-day uptime buckets and the raw probe points (timestamp, verdict, latency).

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Catalog slug."
    },
    "days": {
      "description": "Uptime window width in days (default 14, max 90).",
      "type": "integer",
      "minimum": 1,
      "maximum": 90
    },
    "limit": {
      "description": "Max raw probe points returned (default 30, max 200).",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Reconstructed outage incidents (contiguous runs of failed probes) across the catalog, newest first. Each incident has a start, an end (or ongoing), a duration and the failure reason. Filter to one server with slug, or to open outages with status='ongoing'.

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "Restrict to one server.",
      "type": "string"
    },
    "status": {
      "description": "Restrict by resolution state.",
      "type": "string",
      "enum": [
        "ongoing",
        "resolved"
      ]
    },
    "limit": {
      "description": "Max incidents returned (default 20, max 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Tool-schema and protocol-version drift events detected between successive probes — which servers added, removed or changed tools, and when. Use this to spot breaking changes in a server you depend on. Newest first.

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "Restrict to one server.",
      "type": "string"
    },
    "limit": {
      "description": "Max drift events returned (default 20, max 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Every category and client integration in the MyMCPTools catalog, with the number of servers in each. The slugs returned here are the valid values for the category and integration filters on search_mcp_servers.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Aggregate health of the whole MCP population: verdict breakdown, share of probeable servers actually serving, transport mix, handshake latency percentiles, tool counts and probe freshness. This is the 'how healthy is MCP right now?' headline number.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}