deeptrace

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.

MCP URL https://mcp.ikodo.dev

Get an access token

Step one

Take a token

No 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.

ShellClick to select
$ export DEEPTRACE_TOKEN="<your-token>"
Never

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 two
Claude Code
Add the serverClick to select
$ claude mcp add --transport http deeptrace \
    https://mcp.ikodo.dev \
    --header "Authorization: Bearer $DEEPTRACE_TOKEN"
Config
~/.claude.json
Verify
claude mcp list
Expect
deeptrace · connected, with compare_pools, compare_lending_markets, find_large_swaps, and research_wallet offered in a new session.
OpenCode
opencode.jsonClick to select
{
  "mcp": {
    "deeptrace": {
      "type": "remote",
      "url": "https://mcp.ikodo.dev",
      "enabled": true,
      "headers": { "Authorization": "Bearer {env:DEEPTRACE_TOKEN}" }
    }
  }
}
Config
~/.config/opencode/opencode.json, or opencode.json in the project root.
Verify
Run opencode, then /mcp.
Expect
deeptrace connected, exposing all four read-only research tools.
Codex
config.tomlClick to select
experimental_use_rmcp_client = true

[mcp_servers.deeptrace]
url = "https://mcp.ikodo.dev"
bearer_token_env_var = "DEEPTRACE_TOKEN"
Config
~/.codex/config.toml
Verify
codex mcp list
Expect
deeptrace listed and enabled. Streamable HTTP needs the RMCP client flag.
Any other MCP client
Transport
Streamable HTTP
URL
https://mcp.ikodo.dev
Header
Authorization: Bearer <token>
Verify with curlClick to select
$ 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"}'
Expect
A JSON-RPC result listing compare_pools, compare_lending_markets, find_large_swaps, and research_wallet. Without a token this endpoint answers 401 — that response still proves you reached it.

The canonical URL is https://mcp.ikodo.dev. The older /mcp path remains only for existing client configurations.

Ask the first question

Step three
Paste into your AI clientClick to select
Compare 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

Evidence

Every 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.

compare_pools · 24h · by volumePartial

Ranked pools

1 · uniswap-v3 volume_usd
   pool_address0x6c561b…4171372
2 · pancakeswap-v3 volume_usd
   pool_address0x72ab38…011c2d38

Coverage

requested_deployments2
successful_deployments1
nuthatch_availabletrue

Provenance

source_iduniswap-v3-base-native
query_idm2-tier-b-metrics-v1
methodology_versioncompleted-utc-days-v1

Nuthatch freshness — never a financial value

last_swap_block
recent_swap_count_24h
statusfresh

Warnings

1exchange-v3-base did not answer

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 required

DeepTrace 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.

RecommendedClick to select
$ 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.