Server definition
- Hash
- sha256:a95f13f35222904bd2590f35aaba0215ad911a521b6d7dfa037ab47c176e8b3a
- What it is
- What a remote MCP server returned when asked what it offers: 2 tools
The blob, as servednamed by its sha256
{
"instructions": "This server is the discovery front door to the cyanheads MCP fleet. Use cyanheads_search_catalog to find tools or servers by describing what you want to do. Use cyanheads_describe_entry to get descriptions, connection metadata, and per-client install snippets for any result. Tool schemas are available from the connected server through tools/list. Continue searches with nextOffset and, in tools scope, nextServersOffset; reuse the same query and filters. Scope \"tools\" (default) finds individual tools; scope \"servers\" finds which server owns a workflow. cyanheads_describe_entry also resolves this server itself, under the name \"cyanheads-mcp-server\".",
"tools": [
{
"description": "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 endpoint exists — for every supported client, or one client via the client parameter.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"client": {
"description": "Return install snippets for this client only (both local and remote transports when available). Omit to return snippets for all supported clients.",
"enum": [
"claude-code",
"codex",
"cursor",
"curl",
"gemini",
"streamable-http"
],
"type": "string"
},
"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.",
"enum": [
"tool",
"server"
],
"type": "string"
},
"name": {
"description": "Tool name (snake_case, e.g. \"earthquake_search\") or server name (kebab-case, e.g. \"earthquake-mcp-server\"). 1-64 characters. Exact names win; unique case-insensitive names resolve to canonical names. Use cyanheads_search_catalog to discover valid names.",
"maxLength": 64,
"minLength": 1,
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "cyanheads_describe_entry",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"result"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `not_found`: No tool or server with the given name exists in the catalog. `ambiguous_kind`: Name matches both a tool and a server (collision in catalog). `catalog_empty`: Catalog has not finished loading. Other values are possible when a failure originates below the handler.",
"examples": [
"not_found",
"ambiguous_kind",
"catalog_empty"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"result": {
"description": "The resolved entry — either a tool detail or a server detail depending on the resolved kind.",
"oneOf": [
{
"additionalProperties": false,
"description": "A resolved tool entry — its description and the server that owns it.",
"properties": {
"auth": {
"description": "Owning server hosted authentication requirement.",
"type": "string"
},
"description": {
"description": "Brief description of what the tool does.",
"type": "string"
},
"endpoint": {
"description": "Owning server hosted HTTP endpoint, when available.",
"type": "string"
},
"github": {
"description": "Owning server GitHub repository URL.",
"type": "string"
},
"installNotice": {
"description": "Actionable guidance when the requested client has no compatible installation snippet.",
"type": "string"
},
"installSnippets": {
"description": "Owning server install snippets, filtered by client when supplied.",
"items": {
"additionalProperties": false,
"description": "An installation snippet for the owning server.",
"properties": {
"client": {
"description": "Target MCP client.",
"enum": [
"claude-code",
"codex",
"cursor",
"curl",
"gemini",
"streamable-http"
],
"type": "string"
},
"label": {
"description": "Install method label.",
"type": "string"
},
"payload": {
"description": "Install command or configuration.",
"type": "string"
},
"transport": {
"description": "Local stdio or hosted HTTP transport.",
"enum": [
"stdio",
"http"
],
"type": "string"
}
},
"required": [
"client",
"transport",
"label",
"payload"
],
"type": "object"
},
"type": "array"
},
"kind": {
"const": "tool",
"description": "Resolved as a tool entry.",
"type": "string"
},
"name": {
"description": "Canonical resolved tool name.",
"type": "string"
},
"npm": {
"description": "Owning server npm package for local installation.",
"type": "string"
},
"requiredEnvVars": {
"description": "Environment variable names required for local installation.",
"items": {
"type": "string"
},
"type": "array"
},
"server": {
"description": "Server package name that owns this tool.",
"type": "string"
}
},
"required": [
"kind",
"name",
"description",
"server",
"npm",
"github",
"auth",
"installSnippets"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "A resolved server entry — metadata, optional hosted endpoint, and per-client install snippets.",
"properties": {
"auth": {
"description": "Auth requirement for the hosted deployment (currently always \"none\").",
"type": "string"
},
"description": {
"description": "Brief description of what the server does.",
"type": "string"
},
"displayName": {
"description": "Human-readable server label.",
"type": "string"
},
"endpoint": {
"description": "Streamable HTTP endpoint for the hosted deployment. Absent for local-only (stdio) servers.",
"type": "string"
},
"github": {
"description": "GitHub repository URL.",
"type": "string"
},
"installNotice": {
"description": "Actionable guidance when the requested client has no compatible installation snippet.",
"type": "string"
},
"installSnippets": {
"description": "Install instructions: local (stdio) snippets for every server, plus remote (HTTP) snippets when an endpoint exists. Filtered to one client when input.client is set.",
"items": {
"additionalProperties": false,
"description": "A single install instruction entry.",
"properties": {
"client": {
"description": "MCP client this snippet targets.",
"enum": [
"claude-code",
"codex",
"cursor",
"curl",
"gemini",
"streamable-http"
],
"type": "string"
},
"label": {
"description": "Human-readable install method label.",
"type": "string"
},
"payload": {
"description": "Install payload (JSON fragment or CLI command).",
"type": "string"
},
"transport": {
"description": "Transport this snippet installs — stdio (local) or http (remote).",
"enum": [
"stdio",
"http"
],
"type": "string"
}
},
"required": [
"client",
"transport",
"label",
"payload"
],
"type": "object"
},
"type": "array"
},
"kind": {
"const": "server",
"description": "Resolved as a server entry.",
"type": "string"
},
"name": {
"description": "Canonical resolved server name.",
"type": "string"
},
"npm": {
"description": "npm package name (e.g. \"@cyanheads/arxiv-mcp-server\"). Drives the local stdio snippets.",
"type": "string"
},
"requiredEnvVars": {
"description": "Env var names the local (stdio) install requires (e.g. [\"MAILCHIMP_API_KEY\"]). Absent when none.",
"items": {
"type": "string"
},
"type": "array"
},
"toolCount": {
"description": "Number of tools exposed by this server.",
"type": "number"
},
"tools": {
"description": "Every tool this server exposes, each with its name and a brief description — one describe call reveals the full surface without a second lookup.",
"items": {
"additionalProperties": false,
"description": "A single tool exposed by this server.",
"properties": {
"description": {
"description": "Brief description of what the tool does.",
"type": "string"
},
"name": {
"description": "Tool name (snake_case, e.g. \"earthquake_search\").",
"type": "string"
}
},
"required": [
"name",
"description"
],
"type": "object"
},
"type": "array"
},
"version": {
"description": "Published version captured at fleet-generation time.",
"type": "string"
}
},
"required": [
"kind",
"name",
"displayName",
"description",
"version",
"npm",
"github",
"auth",
"toolCount",
"tools",
"installSnippets"
],
"type": "object"
}
]
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"category": {
"description": "Filter by catalog category. Omit to search all categories.",
"enum": [
"research",
"government",
"public-data",
"utility"
],
"type": "string"
},
"limit": {
"default": 5,
"description": "Maximum number of results to return (1-20). Default 5.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"description": "Result offset. Use nextOffset with the same query, scope, category, and limit; pages use the current catalog.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"query": {
"description": "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.",
"maxLength": 500,
"minLength": 1,
"pattern": "\\S",
"type": "string"
},
"scope": {
"default": "tools",
"description": "What to search. \"tools\" returns individual tool matches; \"servers\" returns server-level matches.",
"enum": [
"tools",
"servers"
],
"type": "string"
},
"serversOffset": {
"default": 0,
"description": "Independent server roll-up offset (10 per page). Use nextServersOffset; must be zero in servers scope.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "cyanheads_search_catalog",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"offset",
"nextOffset",
"results",
"scope",
"effectiveQuery",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"effectiveQuery": {
"description": "The query that was searched.",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `invalid_servers_offset`: A nonzero serversOffset is supplied in servers scope. `catalog_empty`: Catalog has not finished loading. Other values are possible when a failure originates below the handler.",
"examples": [
"invalid_servers_offset",
"catalog_empty"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextOffset": {
"description": "Next ranked-result offset, or null when exhausted.",
"type": [
"number",
"null"
]
},
"nextServersOffset": {
"description": "Next server roll-up offset, or null when exhausted; tools scope only.",
"type": [
"number",
"null"
]
},
"notice": {
"description": "Guidance for zero matches or an exhausted result page. Absent on nonempty result pages.",
"type": "string"
},
"offset": {
"description": "Current ranked-result offset.",
"type": "number"
},
"results": {
"description": "Ranked matches, best first.",
"items": {
"additionalProperties": false,
"description": "A single search result entry.",
"properties": {
"brief": {
"description": "One-line summary of what this tool or server does.",
"type": "string"
},
"category": {
"description": "Catalog category for the owning server.",
"enum": [
"research",
"government",
"public-data",
"utility"
],
"type": "string"
},
"name": {
"description": "Tool name (snake_case) or server name (kebab-case) depending on scope.",
"type": "string"
},
"score": {
"description": "Cosine similarity between query and entry, in [0, 1]. Higher is better. Compare only within a single response.",
"type": "number"
},
"server": {
"description": "Server package name that owns this tool (e.g. \"arxiv-mcp-server\"). Same as name when scope is \"servers\".",
"type": "string"
}
},
"required": [
"name",
"server",
"brief",
"category",
"score"
],
"type": "object"
},
"type": "array"
},
"scope": {
"description": "Scope that was searched.",
"enum": [
"tools",
"servers"
],
"type": "string"
},
"servers": {
"description": "Server roll-up from the full match set, independent of result offset/limit. Tools scope only. Ordered by topScore desc (name-tiebroken); 10 per page starting at serversOffset. Use nextServersOffset to continue and serversTotal for the full distinct count.",
"items": {
"additionalProperties": false,
"description": "A server roll-up entry.",
"properties": {
"brief": {
"description": "One-line description of what the server does.",
"type": "string"
},
"category": {
"description": "Catalog category.",
"enum": [
"research",
"government",
"public-data",
"utility"
],
"type": "string"
},
"matchedTools": {
"description": "Count of this server's tools in the full match set.",
"type": "number"
},
"name": {
"description": "Server package name (e.g. \"cdc-health-mcp-server\").",
"type": "string"
},
"topScore": {
"description": "Best cosine similarity among this server's matched tools. Drives ordering. Distinct from the score a server gets under scope \"servers\".",
"type": "number"
}
},
"required": [
"name",
"brief",
"category",
"matchedTools",
"topScore"
],
"type": "object"
},
"type": "array"
},
"serversOffset": {
"description": "Current server roll-up offset; tools scope only.",
"type": "number"
},
"serversTotal": {
"description": "Total distinct servers in the full match set (before the cap of 10 is applied). Present only when servers is present.",
"type": "number"
},
"totalCount": {
"description": "Total relevant matches before the limit was applied.",
"type": "number"
}
},
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:a95f13f35222904bd2590f35aaba0215ad911a521b6d7dfa037ab47c176e8b3a | sha256sum