cyanheads-mcp-server

v0.4.1 pre-1.0

Fleet discovery for the cyanheads MCP ecosystem — semantic search + install snippets.

public 2 tools protocol 2026-07-28 github cyanheads/cyanheads-mcp-server

cyanheads.caseyjhand.com/mcp

claude mcp add --transport http cyanheads-mcp-server https://cyanheads.caseyjhand.com/mcp

codex mcp add cyanheads-mcp-server --url https://cyanheads.caseyjhand.com/mcp

{
  "mcpServers": {
    "cyanheads-mcp-server": {
      "url": "https://cyanheads.caseyjhand.com/mcp"
    }
  }
}

gemini mcp add --transport http cyanheads-mcp-server https://cyanheads.caseyjhand.com/mcp

{
  "mcpServers": {
    "cyanheads-mcp-server": {
      "command": "bunx",
      "args": [
        "mcp-remote",
        "https://cyanheads.caseyjhand.com/mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "cyanheads-mcp-server": {
      "type": "http",
      "url": "https://cyanheads.caseyjhand.com/mcp"
    }
  }
}

curl -X POST https://cyanheads.caseyjhand.com/mcp \
  -H "Content-Type: application/json" \
  -H "MCP-Protocol-Version: 2026-07-28" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2026-07-28","capabilities":{},"clientInfo":{"name":"curl","version":"1.0.0"}}}'

Built on@cyanheads/mcp-ts-core v0.12.3

Tools

cyanheads_search_catalog

Search fleet tools and servers by natural-language description. Returns ranked matches with brief summaries and the server each tool belongs to. Use scope "servers" to find which server handles a workflow; use the default scope "tools" to find specific tools.

read

scope read

invocation

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "cyanheads_search_catalog",
    "arguments": {
      "query": "<query>"
    }
  }
}

schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "Natural language search query. Describe what you want to accomplish, a workflow, or a capability area. 1-500 characters."
    },
    "scope": {
      "default": "tools",
      "description": "What to search. \"tools\" returns individual tool matches; \"servers\" returns server-level matches.",
      "type": "string",
      "enum": [
        "tools",
        "servers"
      ]
    },
    "category": {
      "description": "Filter by catalog category. Omit to search all categories.",
      "type": "string",
      "enum": [
        "research",
        "government",
        "public-data",
        "utility"
      ]
    },
    "limit": {
      "default": 5,
      "description": "Maximum number of results to return (1-20). Default 5.",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "query",
    "scope",
    "limit"
  ],
  "additionalProperties": false
}

view source ↗

cyanheads_describe_entry

Return the description and install snippets for a named tool or server. For tools: the description and the server it belongs to. For servers: local (stdio, via npx) install snippets for every published server, plus remote (HTTP) connection snippets when a hosted endpoint exists — for every supported client, or one client via the client parameter.

read

scope read

invocation

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "cyanheads_describe_entry",
    "arguments": {
      "name": "<name>"
    }
  }
}

schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Tool name (snake_case, e.g. \"earthquake_search\") or server name (kebab-case, e.g. \"earthquake-mcp-server\"). 1-64 characters. Use cyanheads_search_catalog to discover valid names."
    },
    "kind": {
      "description": "Whether name refers to a tool or server. Omit to auto-detect: names containing underscores are treated as tools; names containing hyphens are treated as servers.",
      "type": "string",
      "enum": [
        "tool",
        "server"
      ]
    },
    "client": {
      "description": "Return install snippets for this client only (both local and remote transports when available). Omit to return snippets for all supported clients.",
      "type": "string",
      "enum": [
        "claude-code",
        "codex",
        "cursor",
        "curl",
        "gemini",
        "streamable-http"
      ]
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

view source ↗