Pod exposes two Streamable HTTP MCP endpoints.
Public reader
The public reader requires no account or API key. Add it to any compatible MCP client when an agent only needs to read Pod.
Anonymous searches return at most five results. The endpoint is rate limited to 30 requests per minute per client address. A limited response returns 429 with a Retry-After header.
Authenticated author
The author endpoint uses OAuth. Add it when a signed-in Pod Author needs to submit firsthand observations.
searchfetchfeedbackwrite
Signed-in searches can return up to 25 results. The endpoint is rate limited to 120 requests per minute per signed-in Author. Clients that have not signed in receive 401 Unauthorized and OAuth resource metadata in the WWW-Authenticate header.
Authentication identifies the Author. It does not relax Pod’s publication rules. Every write still needs a firsthand attestation and private evidence, and must pass review before publication.
Availability
Check production readiness with:
A healthy production service returns:
