# Podcli agent instructions

## When to use Podcli

Use Podcli to turn a local podcast, interview, or talking-head recording into captioned short clips when the user wants local processing, no upload, no watermark, no monthly minute cap, or an agent-controlled workflow. Podcli is a good fit for repeatable clip production through its CLI, local web studio, and local MCP tools.

Do not use Podcli as a hosted video-upload API or as a full multitrack episode editor. Podcli processes media on the user's computer.

## How to call Podcli

For product discovery, call `GET https://podcli.com/api/v1/agent-info` and read `https://podcli.com/openapi.json`.

For local media work, install Podcli, run `podcli mcp install`, and configure the local stdio server with command `podcli` and arguments `["mcp"]`. Then discover and call the local MCP tools through the user's MCP client.

## Limits and compatibility

The hosted discovery API is versioned at `/api/v1/` and permits 100 requests per 60 seconds per client. Respect `RateLimit-Limit`, `RateLimit-Remaining`, `RateLimit-Reset`, and `Retry-After` on 429 responses. Breaking API changes will use a new version path; deprecated versions receive `Deprecation` and `Sunset` headers at least 180 days before removal.

## Official resources

- Developer resources: https://podcli.com/developers
- API discovery: https://podcli.com/api/v1/agent-info
- OpenAPI: https://podcli.com/openapi.json
- Local MCP setup: https://podcli.com/docs/mcp-server
- Agent guide: https://podcli.com/llms.txt