Attester Oracle

io.github.maminihdsPublished by GitHub account maminihdsv0.2.0Updated Oct 24, 2026

Verify PyPI and npm packages, symbols, and version diffs against real artifacts. Free, no account.

VerifiedStreamable HTTPWeb executableDeveloper ToolsSecurity & Monitoring

Overview

AI-generated overview

A hosted oracle that lets an assistant verify PyPI and npm packages, symbols and version diffs against real published artifacts, with signed attestations.

What you can do
Check whether a PyPI or npm package name exists, with typosquat-adjacency flags on misses and a signed attestation per result. Check whether a function, class or constant exists in a package, with closest-match suggestions on misses. Fetch a symbol's exact signature, structured parameters, docstring summary and deprecation status, resolved at a pinned version. Diff two pinned versions of a package at symbol level, classifying changes as breaking, additive or neutral.
When to use it
Useful when an assistant writes or reviews code that imports third-party packages and you want to confirm names, symbols and signatures exist before installing or importing, or to see what changed between two releases.
Requirements
Remote streamable HTTP endpoint; no install, account, API key or wallet needed for the four free oracle tools. Free use is limited to 25 calls per day per client IP, shared across the tools and reset at 00:00 UTC. Higher volume needs paid HTTP routes, prepaid credits via ATTESTER_API_KEY or x402 payment with BUYER_PRIVATE_KEY. A local stdio install from source is also described.
Before you install
Free quota is keyed to client IP and shared across tools, so it can be exhausted by others on the same address. Paid routes cost money per call; prepaid credits are bought through Stripe and x402 payment requires setting BUYER_PRIVATE_KEY, a Base wallet holding USDC, which the wrapper uses to sign payments automatically. Results are signed attestations from a third-party service, so verify receipts if trust matters.

Installation

In SourceWeft

  1. Open Attester Oracle in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.maminihds%2Fattester-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "attester-oracle": {
      "type": "http",
      "url": "https://attester.dev/mcp/"
    }
  }
}

README

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:

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

ToolWhat it doesPrice per call
attester_package_existsDoes this PyPI/npm package name really exist? Typosquat-adjacency flags on misses.Free (25/day keyless); $0.002 paid
attester_symbol_existsDoes this function, class, or constant exist in the package? Closest-match suggestions on misses.Free (25/day keyless); $0.005 paid
attester_symbol_signatureExact signature, structured params, docstring, deprecation status, resolved at a pinned version.Free (25/day keyless); $0.01 paid
attester_version_diffSymbol-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

ToolWhat it doesPrice per call
oracle_verify_workCheck another agent's work: citation support, code correctness, data/schema validation. Verdict plus signed attestation.$0.15 USDC
oracle_code_researchCited coding research; citations are re-checked and the proof attached.$0.10 USDC
oracle_judgeGrade an output against your rubric; signed score with per-criterion evidence.$0.10 USDC
oracle_watchtower_reportSigned 24h report on whether an x402 service honors its advertised prices.$0.05 USDC
oracle_spend_checkPre-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, 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.txtpython 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

Source: README.md at commit d74742e

Tools

4

attester_package_exists

Package Exists (free oracle)

Does this PyPI or npm package name really exist? Deterministic answer from the real published artifact, signed, with typosquat-adjacency flags on misses. Free: 25 calls/day per client IP, shared with the /demo/v1/* HTTP routes, reset 00:00 UTC. Higher volume: paid HTTP routes at https://attester.dev/llms.txt.

Parametersnamerequiredecosystemrequired

attester_symbol_exists

Symbol Exists (free oracle)

Does a function, class, or constant exist in this PyPI or npm package? Answer from the indexed artifact, with closest-match suggestions on misses. Free: 25 calls/day per client IP, shared with the /demo/v1/* HTTP routes, reset 00:00 UTC. Higher volume: paid HTTP routes at https://attester.dev/llms.txt.

Parameterssymbolrequiredpackagerequiredversionecosystemrequired

attester_symbol_signature

Symbol Signature (free oracle)

Exact signature, structured params, docstring summary, and deprecation status for one symbol, resolved at a pinned version when given. Free: 25 calls/day per client IP, shared with the /demo/v1/* HTTP routes, reset 00:00 UTC. Higher volume: paid HTTP routes at https://attester.dev/llms.txt.

Parameterssymbolrequiredpackagerequiredversionecosystemrequired

attester_version_diff

Version Diff (free oracle)

Symbol-level diff between two pinned versions of one package: added, removed, changed signatures, new deprecations, and a breaking/additive/neutral classification. Free: 25 calls/day per client IP, shared with the /demo/v1/* HTTP routes, reset 00:00 UTC. Higher volume: paid HTTP routes at https://attester.dev/llms.txt.

Parameterspackagerequiredecosystemrequiredto_versionrequiredfrom_versionrequired

Version history

1
  1. v0.2.0LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts