> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polymet.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# What your agent can do

> Every tool the Polymet MCP server gives your coding agent, in plain words.

The Polymet MCP server gives your coding agent 11 tools. Your agent picks the right one from your request; you do not call them yourself. The names below are what you will see in your agent's tool list.

Two things need a paid plan: `download_repository`, and some models in `send_prompt`. `send_prompt` is the only tool that spends credits.

## Start and prompt

| Tool | What it does |
| - | - |
| `get_context` | Shows who you are signed in as, your organizations, and each organization's credit balance |
| `create_project` | Creates a new project with its first thread, and returns the project's canvas link |
| `create_thread` | Starts a new thread in a project, for a separate conversation on the same canvas |
| `request_upload` | Gives your agent a one-time link to upload a screenshot, design reference or spec to attach to a prompt |
| `send_prompt` | Sends a prompt to the Polymet Agent, which builds or changes the design. It returns right away while the generation runs |
| `get_status` | Tells your agent whether the generation is running, waiting for you, finished, failed or idle |

## Read the result

| Tool | What it does |
| - | - |
| `get_conversation` | Reads a thread's prompts and the Polymet Agent's answers, so your agent can catch up on what you or others did in Polymet |
| `get_changes` | Shows what changed in the code since a given version |
| `get_files` | Lists the project's files, or reads the ones your agent asks for |
| `list_branches` | Lists the project's branches, which one is the default, and which have a generation running |
| `download_repository` | Gives a link to download the whole project as a ZIP, every branch included. Needs a paid plan |

## Limits

* A prompt can be up to 15,000 characters. Longer content goes in an attached file.
* One prompt can carry up to 3 documents and 3 images. Documents are PDF or text files, like code, Markdown, JSON or CSV. Images are JPEG, PNG, GIF or WebP.
* An upload link from `request_upload` expires after 2 hours. Download links from `download_repository` and attachment links from `get_conversation` expire after 7 days.
* One generation runs per branch at a time. A prompt sent while one is running is refused, not queued.
* A generation stops after 25 minutes.

## Branches

Your agent works on the project's default branch unless you name another one. It does not pick or switch branches on its own, and a generation it starts stays on the branch it was sent to. See [Branches](https://docs.polymet.ai/team/branches.md).

## When Polymet needs you

Some steps of a generation wait for a person, like approving a database change or typing an API key. When that happens, `get_status` reports the generation as waiting for you. Open the canvas link and answer there. Your coding agent cannot approve these for you.

## Related

* [Use Polymet from your coding agent](https://docs.polymet.ai/mcp/overview.md) — set up the server in Claude Code, Claude, Cursor or VS Code
* [Models and thinking effort](https://docs.polymet.ai/canvas/models.md) — the models you can pick, and which need a paid plan
* [Export your code](https://docs.polymet.ai/publish/export-code.md) — the ZIP download inside Polymet
* [Plans](https://docs.polymet.ai/plans/plans.md) — what each plan includes


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.