Developers

The Woof Back publishes each brand's content as machine-readable data so AI agents and applications can consume it directly, without scraping HTML. Everything here is read-only and requires no API key. The full machine description is at /openapi.json (OpenAPI 3.1).

Model Context Protocol

Agents can connect to the MCP endpoint at /mcp and call the read-only content tools: list_articles, get_facts, search_content, get_article, and list_topics.

Endpoints

EndpointDescription
GET /{slug}Fetch one published article. Send Accept: text/markdown for the markdown body, or Accept: text/html for the page.
curl https://thewoofback.com/your-article-slug
GET /qa.jsonEvery answer-first block and FAQ as a schema.org FAQPage (JSON-LD).
curl https://thewoofback.com/qa.json
GET /facts.jsonThe brand’s verifiable, sourced-and-dated facts.
curl https://thewoofback.com/facts.json
GET /llms.jsonStructured index of the brand and its published content for LLMs.
curl https://thewoofback.com/llms.json
GET /llms.txtPlain-text overview: what the site is and when to use it.
curl https://thewoofback.com/llms.txt
GET /agents.txtAgent guidance: fact base, MCP endpoint and citation policy.
curl https://thewoofback.com/agents.txt
GET /feed.xmlRSS feed of published articles.
curl https://thewoofback.com/feed.xml
GET /atom.xmlAtom feed of published articles.
curl https://thewoofback.com/atom.xml
GET /sitemap.xmlEvery published URL.
curl https://thewoofback.com/sitemap.xml
POST /mcpModel Context Protocol server (JSON-RPC 2.0) exposing read-only content tools: list_articles, get_facts, search_content, get_article, list_topics.
curl -X POST https://thewoofback.com/mcp -H 'content-type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Rate limits

Responses advertise the policy via RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset headers. On a 429, honor Retry-After.

Content negotiation

Any article responds to Accept: text/markdown with its markdown body, or Accept: text/html with the page. Responses vary on Accept.