tempo-mcp

Crates.iotempo-mcp
lib.rstempo-mcp
version0.2.1
created_at2026-01-04 03:17:33.407421+00
updated_at2026-01-04 05:18:24.331364+00
descriptionMCP server for Tempo blockchain - enabling AI agents to read/write onchain data
homepage
repositoryhttps://github.com/yongkangc/tempo-mcp-rs
max_upload_size
id2021250
size158,430
YK (yongkangc)

documentation

README

tempo-mcp

image

Crates.io smithery badge License: MIT

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
MCP Clients

Claude Code

claude mcp add tempo tempo-mcp

Smithery

Install MCP Server

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

Tool Description
tempo_get_balance Get token balance for an address
tempo_get_transaction Get transaction details by hash
tempo_decode_transaction Decode and explain a transaction
tempo_get_dex_quote Get swap quote from DEX
tempo_list_tokens List available tokens
tempo_transfer Transfer tokens to an address
tempo_swap Swap tokens on DEX
tempo_faucet Request testnet tokens

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.

Client configuration examples

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

Try these prompts to test all tools

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
Network Tempo Testnet
Chain ID 62320
RPC https://rpc.testnet.tempo.xyz
Explorer https://explore.tempo.xyz

Supported Tokens

Symbol Address
TUSD 0x20C0...0000
TEUR 0x20C0...0001
TGBP 0x20C0...0002

Development

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

License

MIT

Commit count: 0

cargo fmt