Connect via MCP

Every Telemost endpoint is exposed as an MCP tool with pay-per-call in USDC. Connect an MCP client to the remote endpoint, or install the local stdio bridge that pays from your own wallet.

MCP endpoint: https://api.telemost.io/mcp Streamable HTTP

Quickstart

1. List everything for free. Call the telemost_catalog tool (no payment) to get every tool with its price, input/output schema and an example. First success before your first dollar.
2. Pick a tool. For example telemost_channel_info with { "channel": "@durov" }.
3. Pay per call. Paid tools return an x402 payment request; an x402-capable client (or the stdio bridge below) pays in USDC and receives the result. No charge on failure, settlement only after a successful call.

Option A: remote endpoint

Point any MCP client that supports remote Streamable HTTP servers at https://api.telemost.io/mcp. The free telemost_catalog works from any client; paid tools require a client that can attach an x402 payment (use Option B for a drop-in wallet).

Claude Code

claude mcp add --transport http telemost https://api.telemost.io/mcp

Project-scoped (shared via .mcp.json): add --scope project. The resulting .mcp.json:

{
  "mcpServers": {
    "telemost": {
      "type": "http",
      "url": "https://api.telemost.io/mcp"
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "telemost": {
      "url": "https://api.telemost.io/mcp"
    }
  }
}

Claude Desktop

Add a custom connector in Settings, Connectors, Add custom connector, and paste https://api.telemost.io/mcp. For paid tools from Claude Desktop, prefer Option B (a wallet-paying bridge).

Option B: local stdio bridge (pays from your wallet)

The npm package telemost-mcp-server runs locally over stdio, discovers the tools from the live catalog, and pays for paid calls from a wallet you fund. This makes paid tools work in any stdio MCP client. Requires Node 18+.

Claude Desktop

Edit claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/; Windows: %APPDATA%\Claude\; Linux: ~/.config/Claude/), then fully restart the app:

{
  "mcpServers": {
    "telemost": {
      "command": "npx",
      "args": ["-y", "telemost-mcp-server"],
      "env": {
        "EVM_PRIVATE_KEY": "0xYOUR_BASE_WALLET_KEY",
        "MAX_PAYMENT_USDC": "0.5",
        "SESSION_MAX_USDC": "5"
      }
    }
  }
}

On Windows, if a bare npx fails to start, use "command": "cmd" with "args": ["/c", "npx", "-y", "telemost-mcp-server"].

Claude Code

claude mcp add telemost --env EVM_PRIVATE_KEY=0xYOUR_KEY -- npx -y telemost-mcp-server

Cursor

Use the same mcpServers entry as Claude Desktop above in ~/.cursor/mcp.json.

Wallet and payment requirements

• Fund a dedicated wallet with a small USDC balance on Base or Solana. Use a separate low-balance wallet, not your main one.
• Key in env only: EVM_PRIVATE_KEY (Base) and/or SVM_PRIVATE_KEY (Solana). Never commit it; it is never logged.
• Spend caps: MAX_PAYMENT_USDC (per call) and SESSION_MAX_USDC (per session) bound spend; a call above the cap is refused before any payment.
• Prices are not hardcoded: the catalog is the single source of truth. The telemost_catalog tool is always free.

Catalog · OpenAPI · Status · Home