API Reference

All endpoints live under /api/v1. Errors return JSON: {"error": "..."}.

Hosted instance: https://rfc-mcp.connorw600.dev/ — all examples below work against it.

GET /health

curl https://rfc-mcp.connorw600.dev/health

Response:

{
  "status": "ok",
  "db_ready": true,
  "rfc_count": 9742,
  "last_updated": "2026-07-20T12:00:00"
}

status is "starting" while the background index build runs, "ok" when ready, "error" on failure.

GET /rfcs/<number>

RFC metadata with relations.

curl https://rfc-mcp.connorw600.dev/api/v1/rfcs/9000

GET /rfcs/<number>/relations

Just the relation links (obsoletes, obsoleted_by, updates, updated_by, see_also).

curl https://rfc-mcp.connorw600.dev/api/v1/rfcs/9000/relations

GET /rfcs/<number>/text

Full plain-text body.

curl https://rfc-mcp.connorw600.dev/api/v1/rfcs/9000/text

GET /rfcs/<number>/sections

List of sections with ordinal, section_id, title, and level. No content.

curl https://rfc-mcp.connorw600.dev/api/v1/rfcs/9000/sections

GET /rfcs/<number>/sections/<section_id>

Content of one section.

curl https://rfc-mcp.connorw600.dev/api/v1/rfcs/9000/sections/2.1
curl https://rfc-mcp.connorw600.dev/api/v1/rfcs/9000/sections/A

GET /rfcs

Filter and paginate the RFC list.

Param	Description
status	Filter by status (e.g. "Proposed Standard")
keyword	Filter by keyword
author	Filter by author name
since	Publication date lower bound (YYYY or YYYY-MM)
until	Publication date upper bound
limit	Max results (default 25)
offset	Pagination offset

GET /search

Full-text search across whole RFC documents.

curl 'https://rfc-mcp.connorw600.dev/api/v1/search?q=DNS&security&limit=3'

Param	Description
q	Search query (FTS5 syntax)
status	Optional status filter
limit	Max results
offset	Pagination offset

GET /search/sections

Full-text search across individual RFC sections.

curl 'https://rfc-mcp.connorw600.dev/api/v1/search/sections?q=DHCP&limit=5'

Param	Description
q	Search query
rfc	Optional — scope to one RFC number
limit	Max results
offset	Pagination offset