Agent surface

Check before the agent acts.

An MCP server, a REST API with an OpenAPI file, and x402 pay-per-answer. Machine-readable verdicts and evidence for trading and allocation systems.

MCP · one command

claude mcp add ascertain -e ASCERTAIN_URL=https://ascertain.vercel.app -- npx -y ascertain-mcp

Tools: ascertain_check_token, ascertain_readiness, ascertain_verify_finding. Set ASCERTAIN_X402_PRIVATE_KEY to let the server pay 402s automatically.

Claude Desktop / Cursor config

{
  "mcpServers": {
    "ascertain": {
      "command": "npx",
      "args": ["-y", "ascertain-mcp"],
      "env": { "ASCERTAIN_URL": "https://ascertain.vercel.app" }
    }
  }
}

Discovery

OpenAPI 3.1/openapi.json
Agent card/.well-known/agent-card.json
Payment protocolx402 v1 · base-sepolia
Settlement modedemo (verify only)

Pricing is a proposal for the demo. Payment network and facilitator are configurable; see the README for switching from demo to settled mode.

Try it

Watch a paid call, end to end.

Run the pay-per-answer flow

Request, 402, sign, retry, receipt. Throwaway key, no funds move.

Press Run to watch an agent call a paid endpoint end to end.

REST

Endpoints

Method	Path	Returns	Price
GET	/v1/token/{address}/readiness	Verdict + score breakdown	$0.01 (25 free / IP / day)
GET	/v1/token/{address}/integrity	Signals, clusters, effective holders	$0.05
GET	/v1/evidence/{findingId}	Raw receipts + reproduce commands	Free
POST	/v1/preflight	Verdict for an intent, with advisory commentary	Free
GET	/v1/tokens	Indexed tokens with verdict summaries	Free

curl -s https://ascertain.vercel.app/v1/token/MIRA/readiness | jq '{verdict, score, flip: .whatWouldFlipIt}'

curl -s -X POST https://ascertain.vercel.app/v1/preflight \
  -H 'content-type: application/json' \
  -d '{"token":"WAVE","intent":"trader"}' | jq .verdict