> For the complete documentation index, see [llms.txt](https://docs.podigee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.podigee.com/documentation/start-here/ai-agents/mcp-reference.md).

# MCP reference

- [MCP API overview](https://docs.podigee.com/documentation/start-here/ai-agents/mcp-reference/reference.md): Exact public contracts for the Podigee MCP endpoint, tools, resources, prompts, and shared behavior.
- [Endpoint and protocol compatibility](https://docs.podigee.com/documentation/start-here/ai-agents/mcp-reference/endpoint-and-protocol-compatibility.md): Streamable HTTP, JSON-RPC, protocol versions, routing metadata, and stateless behavior.
- [OAuth discovery and authorization](https://docs.podigee.com/documentation/start-here/ai-agents/mcp-reference/oauth-discovery-and-authorization.md): OAuth metadata, public clients, PKCE, consent, resource binding, refresh, and revocation.
- [Scopes and permissions](https://docs.podigee.com/documentation/start-here/ai-agents/mcp-reference/scopes-and-permissions.md): The seven public Podigee MCP scopes and how they combine with resource permissions.
- [Account and tenant binding](https://docs.podigee.com/documentation/start-here/ai-agents/mcp-reference/account-and-tenant-binding.md): One-account grant binding, organization selection, actor identity, and cross-account exclusion.
- [Common tool request and response format](https://docs.podigee.com/documentation/start-here/ai-agents/mcp-reference/common-tool-request-and-response-format.md): Tool-call envelopes, structured results, annotations, controls, and public identifiers.
- [Mutation safety contract](https://docs.podigee.com/documentation/start-here/ai-agents/mcp-reference/mutation-safety-contract.md): Exact preview, confirmation, idempotency, and reauthorization behavior for mutations.
- [Durable operation contract](https://docs.podigee.com/documentation/start-here/ai-agents/mcp-reference/durable-operation-contract.md): Durable operation states, polling, result fields, recovery, cancellation, and authority checkpoints.
- [Pagination, filters, sorting, and time ranges](https://docs.podigee.com/documentation/start-here/ai-agents/mcp-reference/pagination-filters-sorting-and-time-ranges.md): Shared pagination, episode filters, sort values, ISO 8601 dates, and valid range combinations.
- [Errors and recovery behavior](https://docs.podigee.com/documentation/start-here/ai-agents/mcp-reference/errors-and-recovery-behavior.md): JSON-RPC, authentication, authorization, validation, plan, conflict, and retry behavior.
- [Public limits and defaults](https://docs.podigee.com/documentation/start-here/ai-agents/mcp-reference/public-limits-and-defaults.md): Current public batch, upload, operation, analytics, pagination, and import limits.
- [Public object schemas](https://docs.podigee.com/documentation/start-here/ai-agents/mcp-reference/public-object-schemas.md): Summary of the main public object shapes returned by Podigee MCP tools.
- [Media upload protocol](https://docs.podigee.com/documentation/start-here/ai-agents/mcp-reference/media-upload-protocol.md): Opaque upload sessions, direct byte transfer, parts, completion, ownership, and secret handling.
- [Analytics semantics](https://docs.podigee.com/documentation/start-here/ai-agents/mcp-reference/analytics-semantics.md): Analytics range precedence, download fields, plan history, chronological series, and zero filling.
- [Distribution identifiers and states](https://docs.podigee.com/documentation/start-here/ai-agents/mcp-reference/distribution-identifiers-and-states.md): Stable platform keys, direct and manual sets, normalized show states, and episode delivery.
- [Security, privacy, and data boundaries](https://docs.podigee.com/documentation/start-here/ai-agents/mcp-reference/security-privacy-and-data-boundaries.md): Credential, media, private URL, personal data, audit, and external-system boundaries.
- [Compatibility, versioning, and deprecation](https://docs.podigee.com/documentation/start-here/ai-agents/mcp-reference/compatibility-versioning-and-deprecation.md): Protocol eras, pdg policy, clients, languages, contract changes, and deprecation notices.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.podigee.com/documentation/start-here/ai-agents/mcp-reference.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.