Attester Oracle
Verify PyPI and npm packages, symbols, and version diffs against real artifacts. Free, no account.
Open source Repository Open in the app JSON README (API)
About
Verify PyPI and npm packages, symbols, and version diffs against real artifacts. Free, no account.
Details
- Kind
- MCP servers
- Topic
- Developer tools
- Publisher
- maminihds
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 0.2.0
- Last push
- 2026-08-10T13:30:54Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-08-29 04:00:27
- Updated
- 2026-08-29 04:00:27
- Origin id
io.github.maminihds/attester-mcp
README
# attester-mcp
MCP server for [attester.dev](https://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:
```json
{
"mcpServers": {
"attester": {
"url": "https://attester.dev/mcp/"
}
}
}
```
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.)
| Tool | What it does | Price per call |
|---|---|---|
| `attester_package_exists` | Does this PyPI/npm package name really exist? Typosquat-adjacency flags on misses. | Free (25/day keyless); $0.002 paid |
| `attester_symbol_exists` | Does this function, class, or constant exist in the package? Closest-match suggestions on misses. | Free (25/day keyless); $0.005 paid |
| `attester_symbol_signature` | Exact signature, structured params, docstring, deprecation status, resolved at a pinned version. | Free (25/day keyless); $0.01 paid |
| `attester_version_diff` | Symbol-level diff between two pinned versions: added, removed, changed, breaking/additive/neutral. | Free (25/day keyless); $0.02 paid |
**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
```
- Before installing or importing a package, call attester_package_exists (and attester_symbol_exists for specific functions) to confirm the name exists. Never import a name the oracle says does not exist.
```
## Paid tools
| Tool | What it does | Price per call |
|---|---|---|
| `oracle_verify_work` | Check another agent's work: citation support, code correctness, data/schema validation. Verdict plus signed attestation. | $0.15 USDC |
| `oracle_code_research` | Cited coding research; citations are re-checked and the proof attached. | $0.10 USDC |
| `oracle_judge` | Grade an output against your rubric; signed score with per-criterion evidence. | $0.10 USDC |
| `oracle_watchtower_report` | Signed 24h report on whether an x402 service honors its advertised prices. | $0.05 USDC |
| `oracle_spend_check` | Pre-payment counterparty check: should your agent pay this address? | $0.005 USDC |
Payment works two ways:
- **Prepaid credits (humans, no crypto):** buy a $5 pack at
[this Stripe link](https://buy.stripe.com/bJefZhfGo9Uy6zF9ckaZi00), 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:
```bash
# Claude Code
/plugin marketplace add maminihds/attester-mcp
# skills.sh CLI (Claude Code, Cursor, Codex, 30+ agents)
npx skills add maminihds/attester-mcp
# OpenClaw (manifestless Claude bundle)
openclaw plugins install https://github.com/maminihds/attester-mcp
```
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
```bash
pip install -r requirements.txt
python server.py # stdio (default, for agents)
python server.py --http # streamable-http on :8100
```
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
- Site: https://attester.dev
- OpenAPI: https://attester.dev/openapi.json
- llms.txt: https://attester.dev/llms.txt
- Directory listing: https://x402-list.com/services/attester-verification-oracle-verified-research