tempo-mcp

MCP server for Tempo blockchain - query balances, swap tokens, and interact with onchain data through AI assistants.

Demo

https://github.com/user-attachments/assets/efea376f-1723-4095-acc2-ea72323e0425

Quick Example

You: What's my TUSD balance at 0x1234...?
Claude: Your balance is 1,000.50 TUSD

You: Swap 100 TUSD for TEUR
Claude: Swap submitted! Tx: 0xabc... (link to explorer)

Installation

cargo install tempo-mcp

Claude Code

claude mcp add tempo tempo-mcp

Smithery

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "tempo": {
      "command": "tempo-mcp"
    }
  }
}

Codex

Add to ~/.codex/config.toml:

[mcp_servers.tempo]
command = "tempo-mcp"

Or via CLI:

codex mcp add tempo -- tempo-mcp

Amp

Add to .amp/settings.json in your project:

{
  "amp.mcpServers": {
    "tempo": {
      "command": "tempo-mcp"
    }
  }
}

Or via CLI:

amp mcp add --workspace tempo -- tempo-mcp

VS Code

Add to .vscode/mcp.json in your workspace:

{
  "servers": {
    "tempo": {
      "command": "tempo-mcp"
    }
  }
}

Or add globally via Command Palette: MCP: Add Server

Gemini CLI

Add to ~/.gemini/settings.json:

{
  "mcpServers": {
    "tempo": {
      "command": "tempo-mcp"
    }
  }
}

Or via CLI:

gemini mcp add tempo -- tempo-mcp

Cursor

Add to Cursor MCP settings with the same config above.

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json with the same config.

Build from Source

git clone https://github.com/yongkangc/tempo-mcp-rs.git
cd tempo-mcp-rs
cargo build --release

Tools

Security: Private Key Configuration

For transaction tools (tempo_transfer, tempo_swap, tempo_faucet), configure your private key via environment variable instead of passing it in tool calls. This prevents keys from appearing in MCP transcripts.

Claude Desktop / VS Code / Cursor:

{
  "mcpServers": {
    "tempo": {
      "command": "tempo-mcp",
      "env": {
        "TEMPO_PRIVATE_KEY": "0x..."
      }
    }
  }
}

Codex:

[mcp_servers.tempo]
command = "tempo-mcp"

[mcp_servers.tempo.env]
TEMPO_PRIVATE_KEY = "0x..."

Amp:

{
  "amp.mcpServers": {
    "tempo": {
      "command": "tempo-mcp",
      "env": {
        "TEMPO_PRIVATE_KEY": "0x..."
      }
    }
  }
}

Once configured, transaction tools work without passing the key:

You: Send 50 TUSD to 0xabcd...
Claude: Transfer submitted! Tx: 0x...

Example Prompts

List tokens (tempo_list_tokens)

"What tokens are available on Tempo?"

Check balance (tempo_get_balance)

"What's the TUSD balance for 0x1234...?"

Get DEX quote (tempo_get_dex_quote)

"How much TEUR would I get for 100 TUSD?"

Get transaction (tempo_get_transaction)

"Show me transaction 0xabc..."

Decode transaction (tempo_decode_transaction)

"What happened in transaction 0xabc...?"

Request from faucet (tempo_faucet)

"Get me some testnet TUSD from the faucet"

Transfer tokens (tempo_transfer)

"Send 50 TUSD to 0xabcd..."

Swap tokens (tempo_swap)

"Swap 100 TUSD for TEUR"

Network

Supported Tokens

Development

See docs/DEVELOPMENT.md for build, test, and contribution instructions.

License

MIT