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/content

Ask 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

EndpointMethodDescription
/api/contentGETComprehensive structured JSON about the platform: problem, products, security, asset types, audience, use cases, differentiators, and timeline.
/api/faqGETAll FAQs grouped by category (general, launch, product, security, pricing, legal, benefits, technical) as structured JSON.
/api/schemaGETThe complete schema.org JSON-LD graph for the platform (Organization, WebSite, SoftwareApplication, FAQPage, Service, Product, HowTo).
/askPOSTNLWeb natural-language query endpoint. POST {"query":"..."} and receive matched answers from the public content and FAQ. Supports SSE streaming.
/mcpPOSTModel Context Protocol server (Streamable HTTP, JSON-RPC 2.0). Exposes read-only tools: get_overview, search_faqs, get_pricing, compare_alternatives.

Specs & discovery

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.

BlockWill Logo

A DIFC Innovation Company

© 2026 BlockWill Analytical Technologies Limited.

All rights reserved.

BlockWill Analytical Technologies Limited

Level 2, Innovation One, DIFC, Dubai, UAE