Compare Base liquidity pools with verified Graph metrics and independent Nuthatch freshness.
Connect DeepTrace to Claude Code, OpenCode, or Codex. No local installation, no Graph API key, no Tailscale.
Get an access token
Step oneNo wallet, no account, no email. The token is yours alone — if it leaks, only yours is revoked. Export it as DEEPTRACE_TOKEN in the shell that launches your AI client.
$ export DEEPTRACE_TOKEN="<your-token>"
Never paste a token into a chat, put it in a URL, or commit it. This page has no token field and writes nothing to your browser — any site asking you to type a DeepTrace token is not this one.
Lost it? Take another. Tokens are stored only as hashes, so a lost one cannot be recovered — but replacing it costs nothing.
Connect and verify
Step twoClaude Code
$ claude mcp add --transport http deeptrace \ https://mcp.ikodo.dev \ --header "Authorization: Bearer $DEEPTRACE_TOKEN"
OpenCode
{
"mcp": {
"deeptrace": {
"type": "remote",
"url": "https://mcp.ikodo.dev",
"enabled": true,
"headers": { "Authorization": "Bearer {env:DEEPTRACE_TOKEN}" }
}
}
}
Codex
experimental_use_rmcp_client = true [mcp_servers.deeptrace] url = "https://mcp.ikodo.dev" bearer_token_env_var = "DEEPTRACE_TOKEN"
Any other MCP client
$ curl -sS -X POST https://mcp.ikodo.dev \ -H "Authorization: Bearer $DEEPTRACE_TOKEN" \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
The canonical URL is https://mcp.ikodo.dev. The older /mcp path remains only for existing client configurations.
Ask the first question
Step threeCompare Base WETH/USDC pools over the last 24 hours by volume. Show the ranked pools, which sources answered, whether Nuthatch is fresh, and every warning.
You should get back ranked Graph metrics, source coverage, provenance identifiers, and a separate Nuthatch freshness fact.
What comes back
EvidenceEvery field below is real: the addresses, the source identifiers, the methodology version. Only the money is missing, and that is deliberate — a tool that refuses to invent metrics should not invent them on its own front page.
Ranked pools
Coverage
Provenance
Nuthatch freshness — never a financial value
Warnings
Withheld. Real values arrive only from a real query.
This example is partial on purpose. One source timed out, so the ranking honestly covers one of two pools and says so. A result that always succeeds would prove nothing.
The optional skill
Not requiredDeepTrace works the moment MCP is connected. The skill only teaches your AI to preserve exact decimal strings, keep Graph metrics distinct from Nuthatch freshness, and surface partial coverage. Connecting MCP does not automatically install or load the skill.
$ npx skills add https://github.com/ikodo0/deeptrace/tree/develop/skills/deeptrace-pool-research
- Review first
- The installer detects supported agents and asks where to install. Read the skill before approving it.
- Then restart
- Start a new AI session after installing.
- No secrets
- Installing the skill does not configure MCP or store your token.
- Fallback
- If npx skills is unavailable, download the folder from GitHub into your client's skills directory.
What it covers
Current limits- Network
- Base · chain 8453
- Pair
- WETH / native USDC
- Windows
- 24 hours and 7 days
- Rank by
- TVL, volume, or fees — up to three pools
- The Graph
- Supplies every financial metric
- Nuthatch
- Supplies swap-index freshness, large-swap receipts, and source-bounded wallet activity. Graph and Nuthatch stay separate.
- Tools
- compare_pools, compare_lending_markets, find_large_swaps, and research_wallet are live. get_dex_metrics is post-MVP.
- Never writes
- DeepTrace cannot trade, sign, or submit a transaction.
- Never invents
- No model runs inside DeepTrace. Missing data stays missing.
- Never reprices
- USD values come from the source that reported them.
When something is wrong
Common cases- 401
- Token missing, invalid, or expired. Check that DEEPTRACE_TOKEN is exported in the shell that launched your client.
- 403
- Untrusted request origin. Connect from your AI client, not from a web page.
- 404
- Check the hostname: ikodo.dev, not icodo.dev.
- Timeout
- Verify network and hostname. Tailscale is not required and will not help.
- partial
- Not an error. Read coverage and warnings to see which source was unavailable.
- No skill
- Restart the AI client after installing it.
- OAuth only
- Clients that require OAuth are unsupported until wallet sign-in ships. Use one that sends bearer headers.