What you can call today.
The directory is public JSON, CORS open, no key, cached five minutes. The book API (open, pay, hold, sell back) is not published yet; it lands here after the audit, and field names below stay stable when it does.
Directory endpoints
| Method | Path | What |
|---|---|---|
| GET | /api/v1/services | List services. Params: q, live=1, limit (max 500), offset. Answering first, then most recently answered. |
| GET | /api/v1/services/:id | One service with sources and the last 30 probes. |
| GET | /api/v1/stats | Totals: listed, answering, probed, last probe time. |
| POST | /api/v1/submit | List a service. Body: { endpoint, name?, contact? }. Probed on the spot. |
| GET | /ask?q=… | Plain-English query over the directory, JSON back. |
| POST | /api/mcp | MCP server, streamable HTTP, read-only. Tools: find_services, get_service, get_stats. |
| GET | /openapi.json | OpenAPI 3.1 spec. |
| GET | /llms.txt | Plain-text description for crawlers and agents. |
Example
curl "https://purser.ink/api/v1/services?q=search&live=1&limit=5"
{
"id": "api.example.com",
"name": "Example Search",
"endpoint": "https://api.example.com/v1/search",
"category": "Data",
"price_display": "$0.003 / call",
"price_usd": 0.003,
"live": true,
"last_seen_live": "2026-09-09T04:50:29.834Z",
"last_probed_at": "2026-09-09T04:50:29.834Z",
"first_indexed": "2026-09-01T05:00:12.001Z",
"url": "https://purser.ink/s/api.example.com"
}Items also carry the raw rails, chains, assets and facilitator fields exactly as the source declared them, for anyone who needs them.
What "answering" means
We GET each listed URL with a plain user agent and an eight-second timeout. A service is answering when it asks to be paid: an HTTP 402, a payment header, or a payment challenge in the body. Anything else is silent for that probe. Non-HTTP schemes are listed but never probed. Absent from every source for seven days means delisted, never deleted.
MCP
{
"mcpServers": {
"purser": { "url": "https://purser.ink/api/mcp" }
}
}Robinhood Chain
| Field | Value |
|---|---|
| Chain id | 4663 |
| RPC | https://rpc.mainnet.chain.robinhood.com |
| Explorer | https://robinhoodchain.blockscout.com |
| Gas | ETH |
| Settlement asset | USDG |