MCP server

telem-mcp is a stateless MCP stdio server that exposes the Telem SDK as three tools: telem_search, telem_providers, and telem_session_history. It works with any MCP-compatible client, not just Claude Code.

Install

pip install "telem-sdk[mcp]"

This installs telem-sdk with its [mcp] extra, which pulls in the mcp package and registers the telem-mcp console script.

claude mcp add telem -e TELEM_API_KEY=your-telem-api-key -- telem-mcp

{
  "mcpServers": {
    "telem": {
      "command": "telem-mcp",
      "env": {
        "TELEM_API_KEY": "your-telem-api-key"
      }
    }
  }
}

Drop the env block entirely for deployments that don’t require a key — see Authentication.

Tools

Tool	Description
`telem_search`	Search the web for relevant information.
`telem_providers`	List the search providers configured on the Telem backend: name, type, a short description, and which providers run by default when the server sets no `TELEM_PROVIDERS` override.
`telem_session_history`	Show the interaction history of a Telem search session: one numbered line per prior search with its status and query text(s).

telem_session_history additionally requires TELEM_API_KEY to be set in the server’s environment.

Sessions are model-threaded: every telem_search result starts with a Telem session id, and the model passes it back as session_id on every further search serving the same user goal.

Environment variables

Variable	Meaning	Default
`TELEM_API_KEY`	Optional bearer credential. Unset means no `Authorization` header is sent.	none
`TELEM_BASE_URL`	Service endpoint override.	`https://router.telem.ai`
`TELEM_PROVIDERS`	Comma-separated provider allow-list for every search this server runs.	server default
`TELEM_RESULT_MAX_LEN`	Per-result content cap, in characters, fed to the model.	`8000`
`TELEM_TIMEOUT`	Request timeout, in seconds.	`60`

TELEM_API_KEY and TELEM_BASE_URL resolve the same way the SDK resolves them everywhere else — see Authentication.