How do I install the cyanheads mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `MCP_TRANSPORT_TYPE`, `MCP_LOG_LEVEL`, `MCP_HTTP_HOST`, `MCP_HTTP_ENDPOINT_PATH`, `CATALOG_URL`, `EMBEDDING_MODEL_ID` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Cyanheads MCP Server

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

Remote serverstreamable-http

What is the Cyanheads MCP Server?

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

The short version

Declarative tool definitions — single file per tool, framework handles registration and validation
Unified error handling with typed error contracts and recovery hints
Pluggable auth (none, jwt, oauth)
Structured logging with optional OpenTelemetry tracing
Runs locally (stdio/HTTP) or on Cloudflare Workers from the same codebase
Hourly background catalog refresh with atomic swap on generatedAt change — no restart needed when the fleet updates

What it needs from you

Bun v1.3.0 or higher (or Node.js v24+).

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
cyanheads_search_catalog	Search fleet tools and servers by natural-language query. Returns ranked matches with brief summaries and the owning server.
cyanheads_describe_entry	Return the connection URL and per-client install snippets for a named tool or server.

How to install the Cyanheads MCP Server

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

Configuration as documented by the project. Restart the client after saving.

Configuration

Bun v1.3.0 or higher (or Node.js v24+).

Variable	Description	Required
MCP_TRANSPORT_TYPE	Configuration value read at startup.	Optional
MCP_LOG_LEVEL	Configuration value read at startup.	Optional
MCP_HTTP_HOST	Endpoint or connection string the server talks to.	Optional
MCP_HTTP_ENDPOINT_PATH	Filesystem location the server is allowed to use.	Optional
CATALOG_URL	Endpoint or connection string the server talks to.	Yes
EMBEDDING_MODEL_ID	Configuration value read at startup.	Optional

Example prompts to try

“Use Cyanheads to cyanheads search catalog.”
“Use Cyanheads to cyanheads describe entry.”
“Use Cyanheads to Prerequisites.”

Frequently asked questions

Fleet discovery for the cyanheads MCP ecosystem — semantic search + install snippets. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.