API
Guide API
| Method | Path | Purpose |
|---|---|---|
| GET | /api/guides | List published guides. |
| GET | /api/guides/search?q=:query | Search guide titles and descriptions with title-weighted ranking. |
| GET | /api/categories | List current public categories and tags. |
| GET | /api/guides/:slug | Return the latest guide package. |
| GET | /api/guides/:slug/price?link=:linkId | Return configured commerce link live/fallback price status. Omitting link uses the primary buy link. |
| GET | /request | Public page for requesting a new Field Guide. |
| POST | /api/guide-requests | Submit a public guide request for automated triage. |
| GET | /api/guide-requests/inbox.md | Private Markdown inbox for scheduled agents with a bearer admin token. |
| POST | /api/guide-requests/triage | Private automated request cleanup, dedupe, accept, and reject pass. |
| GET | /openapi.json | Return the public OpenAPI description. |
| GET | /.well-known/api-catalog | Return the RFC 9727 API catalog as application/linkset+json. |
| GET | /.well-known/mcp/server-card.json | Return the MCP server card for agent discovery. |
| GET | /.well-known/agent-skills/index.json | Return the Agent Skills discovery index. |
| GET | /.well-known/oauth-authorization-server | Return OAuth metadata explicitly advertising no supported OAuth grants. |
| GET | /.well-known/oauth-protected-resource | Return protected-resource metadata noting that public read APIs do not require OAuth. |
| GET | /health | Return public API health metadata. |
| GET | /guides | Browse all published guides with progressive loading and sort controls. |
| GET | /guides.md | Return all published guides as Markdown. |
| GET | /c | Browse all public guide categories. |
| GET | /c.md | Return all categories and their current guide lists as Markdown. |
| GET | /g/:slug.md | Return the guide as token-efficient Markdown. |
| GET | /c/:category.md | Return a category page as Markdown. |
| GET | /index.md | Return the guide index as Markdown. |
| GET | /llms.txt | Return the agent-facing site map and retrieval notes. |
| POST | /api/guides/:slug/publish | Publish a guide package with a bearer admin token. |
| POST | /mcp | Remote MCP server with Markdown-returning search_guides, get_guide, and list_taxonomy tools. |
curl https://fieldguides.co/api/guidescurl "https://fieldguides.co/api/guides/search?q=macbook"curl -H "Accept: text/markdown" https://fieldguides.co/curl https://fieldguides.co/guides.mdcurl -X POST https://fieldguides.co/api/guide-requests -H "content-type: application/json" -d '{"topic":"Example product","decisionQuestion":"What should buyers know?"}'curl https://fieldguides.co/.well-known/api-catalogcurl https://fieldguides.co/g/macbook-air-m5.mdcurl https://fieldguides.co/llms.txtnpx mcp-remote https://fieldguides.co/mcp