attester-mcp
MCP server for attester.dev: verification and
API-existence oracle tools for AI agents, callable from any MCP client
(Claude Code, Cursor, Windsurf, LangChain, CrewAI).
Every result ships with a wallet-signed attestation you can verify without
trusting us: POST https://attester.dev/receipts/verify is free.
Quickstart: free oracle tools, no keys
No install needed. Point your MCP client at the hosted endpoint:
Four oracle tools work immediately: no account, no API key, no wallet.
You get 25 free calls per day per client IP, shared across the four
tools, resetting 00:00 UTC. (This config block works for Claude Code,
Claude Desktop, and Cursor; any MCP client that speaks streamable HTTP.)
Run it locally instead (stdio): install from source with
pip install git+https://github.com/maminihds/attester-mcp.git, then use
"command": "attester-mcp" in the config above. A zero-install
uvx attester-mcp command lands once the package is published to PyPI.
Steer your agent: CLAUDE.md / Cursor Rules snippet
Paid tools
Payment works two ways:
- Prepaid credits (humans, no crypto): buy a $5 pack at
this Stripe link, claim
the
att_live_... key once at
https://attester.dev/credits/claim?session_id=cs_..., and set
ATTESTER_API_KEY=att_live_... in the server env. Every paid call
deducts from the balance. Check it at
GET https://attester.dev/credits/balance with the key.
(CREDITS_API_KEY still works as an alias.) The free oracle tools honor
the key too: the demo routes skip the daily quota for it and never
charge.
- x402 (agents with wallets): set
BUYER_PRIVATE_KEY to a Base wallet
with USDC. The wrapper pays per call automatically (402, sign, retry)
and sends the wallet address as X-Payer, which keys the paid
endpoints' free quotas.
Without any key, the paid endpoints answer HTTP 402 with payment terms in
the body.
Agent skill bundle (skills/attester)
The same API, packaged as an Agent Skill so agent configs load it as a
default tool: when-to-use rules, exact curl per endpoint (the keyless
/demo/v1/* free path for oracle checks, X-Payer free quotas for the
rest), verdict reading, and receipt verification.
Install paths:
Or copy skills/attester/ into ~/.claude/skills/ manually. The bundle
has a helper (skills/attester/scripts/call.py, stdlib + httpx) and two
worked transcripts in skills/attester/examples/.
Install from source
Environment variables:
SERVER_URL: API base URL, defaults to https://attester.dev.
ATTESTER_API_KEY: prepaid credits key (att_live_...), optional.
BUYER_PRIVATE_KEY: Base wallet for x402 payment, optional.
Example clients
examples/plain_python.py: direct x402-paid call with the official SDK.
examples/langchain_example.py: LangChain tool wrapper.
Links