Tereno on Base — Claude Code MCP server: what it does, how to install
Inspects Base contracts, unsigned transactions, and web targets before execution. Free pricing lookups, per-call USDC settlement via x402.
claude mcp add --transport http tereno https://www.tereno.xyz/api/mcpWhat Tereno on Base does
The server equips coding agents with verification tools for the Base network. Running contract_guard or transaction_intent_guard simulates gas usage, reports allowance changes, and detects unverified proxy updates. Every paid response pins the exact block height where evidence expires.
Querying capabilities via tereno_catalog and inspecting rates with tereno_price requires no wallet. When another agent has recently settled the same deterministic query, Tereno applies a lower reuse price instead of computing from scratch.
Paying directly through stdio fails because stdio transport cannot return payment headers. For automated paid settling, connect your client to the hosted HTTP endpoint at https://www.tereno.xyz/api/mcp.
What it helps with
- Simulate an unsigned Base transaction before signing
- Check contract code and proxy status for post-audit tampering
- Inspect call costs and reuse discounts before paying
- Fetch validated token metadata and interface standards
Example prompts for the agent
- List available audit capabilities using
tereno_catalog - Check the settlement price for a contract call via
tereno_price - Analyze allowance changes and gas deltas with
transaction_intent_guard
How to install Tereno on Base
1Platform CLI: remote server
claude mcp add --transport http tereno https://www.tereno.xyz/api/mcp2Platform CLI
claude mcp add tereno-on-base -- npx -y tereno-mcp1Platform CLI: remote server
codex mcp add tereno-on-base --url https://www.tereno.xyz/api/mcp2Platform CLI
codex mcp add tereno-on-base -- npx -y tereno-mcpConfig file
{
"mcpServers": {
"tereno-on-base": {
"url": "https://www.tereno.xyz/api/mcp"
}
}
}{
"mcpServers": {
"tereno-on-base": {
"command": "npx",
"args": [
"-y",
"tereno-mcp"
]
}
}
}Config file
{
"servers": {
"tereno-on-base": {
"type": "http",
"url": "https://www.tereno.xyz/api/mcp"
}
}
}{
"servers": {
"tereno-on-base": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"tereno-mcp"
]
}
}
}1Platform CLI: remote server
gemini mcp add -t http tereno-on-base https://www.tereno.xyz/api/mcp2Platform CLI
gemini mcp add tereno-on-base npx -y tereno-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Tereno on Base
How to install Tereno on Base in Claude Code?
Add the hosted HTTP server by running claude mcp add --transport http tereno https://www.tereno.xyz/api/mcp. Alternatively, configure stdio execution with claude mcp add tereno-on-base -- npx -y tereno-mcp.
What does Tereno on Base do?
It lets coding assistants verify Base smart contracts, simulate transaction side-effects, and fetch public web artifacts paired with on-chain validity limits.
Do free tools require a connected wallet?
No. The catalog, price quote, and settlement receipt tools run without an API key or a connected wallet.
