Tempo MCP Rs
MCP server for Tempo blockchain - enabling AI agents to read/write onchain data
Ask AI about Tempo MCP Rs
Powered by Claude · Grounded in docs
I know everything about Tempo MCP Rs. Ask me about installation, configuration, usage, or troubleshooting.
0/500
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
