📦

Tempo MCP Rs

MCP server for Tempo blockchain - enabling AI agents to read/write onchain data

0 installs

Trust: 34 — Low

Blockchain

Ask AI about Tempo MCP Rs

I know everything about Tempo MCP Rs. Ask me about installation, configuration, usage, or troubleshooting.

0/500

Loading tools...

Reviews

Documentation

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

MCP Clients

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

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