mcpindex

Recommend the best MCP servers for a natural-language task. Returns top 3 ranked picks with reasoning, install commands, and quality scores. Use this when the user asks for the right MCP server for a task they want to do.

{
  "type": "object",
  "properties": {
    "task": {
      "type": "string",
      "description": "Natural-language description of the task, e.g. \"read PDFs and write to S3\"."
    }
  },
  "required": [
    "task"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Keyword + semantic search across every MCP server mcpindex indexes. Use when the user knows what tool category they want but not which server.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query."
    },
    "category": {
      "description": "Optional category filter (e.g. database, browser, github).",
      "type": "string"
    },
    "limit": {
      "description": "Max results (default 10, max 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Get the exact install command for a given MCP server and client. Returns a JSON block ready to paste into the client config.

{
  "type": "object",
  "properties": {
    "server_slug": {
      "type": "string",
      "description": "Slug of the server (from search or recommend results)."
    },
    "client": {
      "type": "string",
      "enum": [
        "claude-desktop",
        "claude-code",
        "cursor",
        "gemini-cli",
        "cline"
      ],
      "description": "Target client."
    }
  },
  "required": [
    "server_slug",
    "client"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Side-by-side comparison of 2-5 MCP servers - quality scores, install paths, env vars.

{
  "type": "object",
  "properties": {
    "slugs": {
      "minItems": 2,
      "maxItems": 5,
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Server slugs to compare."
    }
  },
  "required": [
    "slugs"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Pre-invocation advisory screen for a specific tool on an MCP server. Returns an advisory verdict object (directive ALLOW | DENY | REVIEW | UNVERIFIED, dimensions, freshness). At v1 the public screen produces REVIEW or UNVERIFIED only - ALLOW/DENY are reserved. Not the in-path gate (mcpindex-gate). Agents SHOULD treat UNVERIFIED as "human review required", never as ALLOW.

{
  "type": "object",
  "properties": {
    "server_id": {
      "type": "string",
      "description": "Registry slug from search_mcp_servers / recommend results, e.g. \"io-github-microsoft-playwright-mcp\" (NOT a short name like \"github\")."
    },
    "tool_name": {
      "type": "string",
      "description": "Tool name as exposed by the server (e.g. \"create_pull_request\")."
    }
  },
  "required": [
    "server_id",
    "tool_name"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Aggregated pre-flight trust assessment across all tools on an MCP server. Same verdict shape as check_tool_trust. Use for "is THIS server worth integrating?" decisions. v1 advisory; conformance monitored not enforced; verdicts may be UNVERIFIED if not yet probed.

{
  "type": "object",
  "properties": {
    "server_id": {
      "type": "string",
      "description": "Server slug to assess."
    }
  },
  "required": [
    "server_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}