{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_m8v82n9sc7sh","handle":"mev-mcp","url":"https://wellknown.network/agents/mev-mcp","links":{"self":"https://wellknown.network/agents/mev-mcp/record.json","html":"https://wellknown.network/agents/mev-mcp","markdown":"https://wellknown.network/agents/mev-mcp/record.md","api":"https://wellknown.network/api/v1/agents/mev-mcp","status":"https://wellknown.network/api/v1/agents/mev-mcp/status","claim":"https://wellknown.network/agents/mev-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mev-mcp/claim.json","badge":"https://wellknown.network/agents/mev-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mev-mcp/history","tools":"https://wellknown.network/api/v1/agents/mev-mcp/tools"},"ard":{"identifier":"urn:air::server:mev-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mev-mcp","summary":"MCP server for MEV-relevant on-chain data: gas price percentiles and bounded mempool watching for pending swaps.","description":"# mev-mcp\n\nAn MCP server for inspecting MEV-relevant activity on Polygon — pending mempool traffic, confirmed swap history, and gas pricing — exposed as tools an AI agent (or you, via Claude Desktop) can call directly.\n\nThis is a diagnostic and research tool, not a production MEV detector. It's built to be honest about what it sees and what it misses, rather than to look more capable than it is.\n\n## What it does\n\n| Tool | What it tells you | Source |\n|---|---|---|\n| `check_pending_swaps_on_pool` | Pending transactions touching a given Uniswap v3 pool, broken down by route type, plus a self-check against confirmed history | Public mempool (`eth_subscribe`) |\n| `check_confirmed_swaps_on_pool` | Ground-truth swap count and originating contracts for a pool over a recent block range | Finalized chain state (`eth_getLogs`) |\n| `get_gas_price_percentiles` | Gas price distribution over recent blocks | `eth_feeHistory` |\n| `hello` | Connectivity check | — |\n\nPolygon only. Arbitrum uses a centralized sequencer with no public mempool, so pending-transaction tools aren't meaningful there.\n\n## The honest part: mempool coverage is partial, and the tool tells you so\n\nSwaps on a given pool can be routed through many different contracts — Uniswap's own `SwapRouter`, `SwapRouter02`, `UniversalRouter`, or any of a long list of aggregators (1inch, Odos, Paraswap, and others). `check_pending_swaps_on_pool` currently decodes:\n\n- Direct calls to the pool contract\n- `SwapRouter` / `SwapRouter02` single-hop swaps (`exactInputSingle`, `exactOutputSingle`) and multi-hop swaps (`exactInput`, `exactOutput`, via packed-path decoding)\n- `UniversalRouter` `V3_SWAP_EXACT_IN` / `V3_SWAP_EXACT_OUT` commands\n- `1inch AggregationRouter v6` swaps\n\nThat's a meaningful slice of mempool traffic, but it is **not exhaustive**. In testing on a moderately active Polygon pool, well over half of confirmed swap volume routed through contracts outside this list — other aggregators, smart-contract wallets, and rou…","publisher":{"name":"Ratsitohery Matthieu","url":null},"homepage":"https://github.com/matiosera3-ops/mev-mcp","repository":"https://github.com/matiosera3-ops/mev-mcp","version":"0.1.0","license":null,"protocols":["mcp"],"tags":["defi","ethereum","mcp","mempool","mev","polygon","web3"],"pricing":null,"endpoints":[{"url":"pypi:mev-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"finance.markets","name":"Markets & Trading","confidence":1,"provenance":"declared"}],"categories":["finance"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mev-mcp","registry":"pypi","observedAt":"2026-11-03T17:26:13.308Z","publishedAt":"2026-06-25T11:06:44.931105Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mev-mcp","url":"https://pypi.org/project/mev-mcp/","firstSeenAt":"2026-09-10T05:23:20.841Z","fetchedAt":"2026-11-03T17:25:40.352Z","normalizedAt":"2026-11-03T17:25:40.352Z"}]},"firstSeenAt":"2026-09-10T05:23:20.841Z","updatedAt":"2026-11-03T17:26:13.308Z"}