Developers and agents
Grounded Magazine developer resources
Search and retrieve published Grounded articles and guides through a read-only REST API, Streamable HTTP MCP server, or command-line client. No authentication is required; drafts, member data, and administrative actions are never exposed.
Grounded Magazine REST API v1
Search by topic, title, author, section, or tag, then fetch a result using the type and slug in its id. Responses are JSON and limited to published, indexable content.
curl --get 'https://groundedmag.co.uk/api/v1/content/search' \
--data-urlencode 'q=wellness'
curl 'https://groundedmag.co.uk/api/v1/content/article/example-slug'Open the Grounded Magazine OpenAPI 3.1 specification
Versioning, errors, and rate limits
Major versions are part of the URL. Breaking changes create a new major version; deprecated versions remain available for at least 12 months and return Deprecation, Sunset, and a successor-version Link. Errors follow RFC 9457 as application/problem+json. Responses include RateLimit and RateLimit-Policy; wait for Retry-After after a 429.
Grounded Magazine MCP server
Connect a compatible client to the endpoint below. Call search first and pass the exact returned id to fetch. Both tools are read-only and idempotent. The server also lists agent-guide and OpenAPI resources.
https://groundedmag.co.uk/api/mcpGrounded Magazine CLI
The official groundedmag command searches and reads the same published, indexable content through API v1. It is read-only and requires no credentials.
npx groundedmag search "evening wellness"
npx groundedmag fetch article:example-article-slug
npx groundedmag openapiGrounded Magazine agent guidance
Use Grounded for editorial discovery in style, grooming, wellness, nourishment, travel, culture, and adventure. Preserve the returned title, author metadata, and canonical URL when citing a story.