# BlockWill API

> Public, read-only API for AI agents. No authentication required for the endpoints below.

## Endpoints

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

## Discovery & Specs

- OpenAPI 3.1 spec: https://www.blockwill.io/openapi.json
- API catalog (RFC 9727): https://www.blockwill.io/.well-known/api-catalog
- MCP server card: https://www.blockwill.io/.well-known/mcp/server-card.json
- Agent discovery: https://www.blockwill.io/.well-known/agent.json

## Authentication

Public endpoints need no auth. The authenticated programmatic API ships with the
Q1 2026 launch. Discovery: https://www.blockwill.io/.well-known/oauth-protected-resource
Guide: https://www.blockwill.io/auth.md

## Errors & Rate Limits

Unknown /api/* paths return a structured JSON 404. The versioned API root
(https://www.blockwill.io/api/v1) returns 401 with a WWW-Authenticate hint. The /mcp and
/ask endpoints are limited to 60 requests/minute per IP and return X-RateLimit-*
headers, plus Retry-After on a 429.