Developer reference
Inspect first. Pay only with intent.
Machine-readable discovery, ten MCP tools, signed evidence contracts, and bounded x402 routes for buyers that need attributable decisions.
- Protocol
- x402 on Base mainnet
- Discovery
- Public manifest + agent catalog
- Evidence
- EIP-191 route receipts + frozen GUARD contract
- Safety
- A no-payment request should return 402
No-spend quickstart
Read the challenge before authorizing settlement.
This request does not include a payment header. A correctly configured paid route should answer with HTTP 402 and payment requirements. Review the amount, network, asset, and pay-to address before using an x402 client.
curl -i 'https://mako.pollinateresearch.com/api/pulse/score?url=https%3A%2F%2Fexample.com'
# Expected before payment:
# HTTP/2 402
# payment-required: <base64-encoded x402 requirements>Payment safety boundary
Commercial assurance routes
Composable signals with explicit prices.
The public manifest is authoritative for current payment requirements. Prices below describe the repository configuration and can drift from a future live response.
Bind preflight risk, buyer policy, hashed payment proof, delivery evidence, and recourse guidance into one signed assurance result.
Return a bounded route recommendation and alternatives composed from Pulse, pricing, reputation, and verification signals.
Inspect discovery metadata or a live 402 challenge and return a signed preflight verdict without settling the target route.
Summarize observed endpoint reliability across a selected time window; unknown remains distinct from low quality.
Combine attributable wallet history with available public identity evidence and return provenance with confidence.
Return observed per-category price distributions from eligible records, with denominators and source boundaries.
Return the bounded reliability envelope used by the AsterPay integration reference; free and rate-limited in repository policy.
MCP installation
Expose the routes as agent tools.
The open-source MCP package maps the commercial and legacy route catalog into ten tools. Paid tools settle real USDC when a funded buyer key is configured.
npm install -g @pollinateresearch/mako-mcp
{
"mcpServers": {
"mako": {
"command": "mako-mcp",
"env": { "X402_BUYER_PRIVATE_KEY": "managed-outside-this-file" }
}
}
}Evidence contracts
Verify the record, not the sales copy.
The published GUARD receipt and claim taxonomy are frozen, content-hashed specifications. The signer registry remains the authority for allowed signing addresses.
| Artifact | Purpose | Verification path |
|---|---|---|
| GUARD receipt v1.0.0 | Binds request and response hashes, quoted and settled amounts, payer, settlement reference, and delivery state. | Rendered spec · Raw text |
| Claims taxonomy v1.0.0 | Defines detectable buyer failures and the evidence required to make each claim reviewable. | Rendered taxonomy · Raw JSON |
| Signer registry | Lists authorized receipt signers for independent signature verification. | Registry JSON |
| x402 reality snapshot | Machine-readable aggregate of current no-payment probe observations and methodology limits. | Snapshot JSON |
Machine discovery
One surface, several readers.
x402 manifest · agent directory · commerce handles · LLM reference. For a bounded human review, qualify the endpoint before checkout.