Cyanheads Mcp Server

cyanheads/cyanheads-mcp-server

A discovery layer for the cyanheads MCP ecosystem. Two tools: semantic search across 40+ servers in research, government, public data, and utility categories, plus install snippet generation for any server or tool in the fleet. Search uses Snowflake Arctic embeddings truncated to 256 dimensions, returns cosine similarity scores, and lets you filter by category or scope (tools vs servers). Describe returns connection URLs and per-client config snippets for both stdio and Streamable HTTP transports. The catalog lives at caseyjhand.com/fleet.json with baked embeddings, refreshed hourly. Useful when you need to browse or programmatically discover what's available in the fleet without checking individual repos.

GitHub stars: 1
tools: 2
transport: STDIO, HTTP
env vars: 11
last updated: Oct 28, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://cyanheads.caseyjhand.com/mcp --name cyanheads

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

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

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 2 tools

Verified live against the running server on Nov 6, 2026.

cyanheads_search_catalogSearch 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.6 params

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.

Parameters* required

categorystring

Filter by catalog category. Omit to search all categories. Categories are catalog labels, not publisher types (a federal agency API can be public-data), and a wrong guess silently drops the matchin...one of research · government · public-data · utility

limitinteger

Maximum number of results to return (1-1000). Default 5. At most 20 per call: a larger limit returns up to 20, with a notice naming the offset to continue from when more matches follow.default: 5

offsetinteger

Result offset. Use nextOffset with the same query, scope, category, and limit; pages use the current catalog.default: 0

query*string

Natural language search query. Describe what you want to accomplish, a workflow, or a capability area. 1-500 raw characters; surrounding whitespace is trimmed. Must contain non-whitespace text.

scopestring

What to search. "tools" returns individual tool matches; "servers" returns server-level matches.one of tools · serversdefault: tools

serversOffsetinteger

Independent server roll-up offset (10 per page). Use nextServersOffset; must be zero in servers scope.default: 0

cyanheads_describe_entryReturn the description and install snippets for a named tool or server. For tools: the description, owning server, and connection metadata. For either kind: local (stdio, via npx) install snippets for every published server, plus remote (HTTP) connection snippets when a hosted...4 params

Return the description and install snippets for a named tool or server. For tools: the description, owning server, and connection metadata. For either kind: local (stdio, via npx) install snippets for every published server, plus remote (HTTP) connection snippets when a hosted...

Parameters* required

clientstring

Return install snippets for this client only (both local and remote transports when available). "streamable-http" selects the generic mcpServers JSON; "curl" selects a connectivity probe for hosted...one of claude-code · cline · codex · cursor · curl · gemini

kindstring

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.one of tool · server

name*string

Tool name (snake_case, e.g. "earthquake_search_events") or server name (kebab-case, e.g. "earthquake-mcp-server"). 1-64 characters. Exact names win; unique case-insensitive names resolve to canonic...

serverstring

Server that owns the tool to describe — the server value cyanheads_search_catalog returned with this name. 1-64 characters, resolved like a server name. Required when the tool name has more than on...

Configuration

MCP_LOG_LEVELdefault: info

Minimum log level: debug, info, notice, warning, error.

CATALOG_URLdefault: https://caseyjhand.com/fleet.json

Remote fleet.json endpoint (schema v2 with baked embeddings).

CATALOG_FETCH_TIMEOUT_MSdefault: 10000

Per-request timeout for fleet.json fetches: integer milliseconds from 1 to 2147483647.

CATALOG_REFRESH_SECONDSdefault: 3600

Background poll interval for fleet.json refreshes in seconds. 0 disables refresh; positive values up to 2147483.647 use the runtime's millisecond timer resolution.

EMBEDDING_MODEL_IDdefault: Snowflake/snowflake-arctic-embed-m-v1.5

Hugging Face model id for query embedding. Must match fleet.json.embeddingModel.

SIMILARITY_FLOORdefault: 0.3

Cosine similarity cutoff for cyanheads_search_catalog results. Must be within [0, 1].

MCP_TRANSPORT_TYPEdefault: http

Selects the HTTP transport.

MCP_HTTP_HOSTdefault: 127.0.0.1

Hostname for the HTTP server.

MCP_HTTP_PORTdefault: 3010

Port to run the HTTP server on.

MCP_HTTP_ENDPOINT_PATHdefault: /mcp

Endpoint path for the MCP server.

MCP_AUTH_MODEdefault: none

Authentication mode: none, jwt, or oauth.

Readme

@cyanheads/cyanheads-mcp-server

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

2 Tools • 0 Resources • 0 Prompts

View the full README on GitHub

Details

Repository: github.com/cyanheads/cyanheads-mcp-server
Category: Search & Web Crawling
Package: @cyanheads/cyanheads-mcp-server
Transport: STDIO, HTTP
Registry: MCP registry, active
Resources: 1
Tools verified: Nov 6, 2026

Related Search & Web Crawling MCP servers

View all

Gbif Biodiversity Mcp Servercyanheads/gbif-biodiversity-mcp-serverSearch GBIF species taxonomy, occurrence records, datasets, and publishers.1stars

Nist Nvd Mcp Servercyanheads/nist-nvd-mcp-serverSearch and audit NIST NVD CVEs by keyword, severity, CWE, CISA KEV status, and CPE.1stars

Usda Mcp Servercyanheads/usda-mcp-serverSearch foods, compare nutrients, and look up the full USDA FoodData Central database.1stars

Disney Lorcana MCPdanielenricocahall/lorcana-mcpMCP server for Disney Lorcana TCG: card search, deck validation, stats, and deck import/export1stars

Rollin Mcp Serverdavidsirota/rollin-mcp-serverWheelchair accessibility scores for 70,000+ US restaurants. Search, filter, and submit feedback.1stars

Tripitaka MCPdhamma-seeker/tripitaka-mcpMCP server for the full Pāli Canon — search, cite, compare translations. Offered as Dhamma Dāna.1stars