Developers & AI Agents
BlockWill exposes a public, read-only API so AI agents and developers can answer questions about the platform without scraping HTML. Every endpoint below is unauthenticated. Programmatic account access ships with the Q1 2026 launch.
Quickstart
Fetch platform content
curl https://www.blockwill.io/api/contentAsk a question (NLWeb /ask)
curl -X POST https://www.blockwill.io/ask \
-H "Content-Type: application/json" \
-d '{"query": "How does BlockWill protect crypto when I die?"}'Call an MCP tool (JSON-RPC 2.0)
curl -X POST https://www.blockwill.io/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"get_pricing","arguments":{"region":"uae"}}}'Endpoints
| Endpoint | Method | Description |
|---|---|---|
| /api/content | GET | Comprehensive structured JSON about the platform: problem, products, security, asset types, audience, use cases, differentiators, and timeline. |
| /api/faq | GET | All FAQs grouped by category (general, launch, product, security, pricing, legal, benefits, technical) as structured JSON. |
| /api/schema | GET | The complete schema.org JSON-LD graph for the platform (Organization, WebSite, SoftwareApplication, FAQPage, Service, Product, HowTo). |
| /ask | POST | NLWeb natural-language query endpoint. POST {"query":"..."} and receive matched answers from the public content and FAQ. Supports SSE streaming. |
| /mcp | POST | Model Context Protocol server (Streamable HTTP, JSON-RPC 2.0). Exposes read-only tools: get_overview, search_faqs, get_pricing, compare_alternatives. |
Specs & discovery
- OpenAPI 3.1 spec —
/openapi.json - MCP server card —
/.well-known/mcp/server-card.json(server at/mcp) - Agent discovery and A2A agent card
- API catalog (RFC 9727)
- llms.txt · llms-full.txt · /api/llms.txt
- Markdown homepage · pricing.md
Authentication
The endpoints above are public and need no credentials. The authenticated programmatic API is gated by OAuth 2.0; discover it at /.well-known/oauth-protected-resource and follow the agent walkthrough in auth.md. Partner integrations: partners@blockwill.io.
Rate limits
The /mcp and /ask endpoints are rate limited to 60 requests per minute per IP. Responses include X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset; on a 429 a Retry-After header tells you how long to back off.