AI assistants (MCP)
Podsworth is a remote MCP server. An AI assistant connected to it can check your balance, estimate a cost, create and submit projects, follow them and fetch the downloads, using the same projects and credits as the API.
https://api.podsworth.com/mcpConnecting
Section titled “Connecting”Add that address to your assistant as a remote MCP server (in Claude: a custom connector). The first time it’s used, the assistant opens Podsworth’s sign-in page, then a page where you choose:
- the account it acts for, if you’re in a team;
- live or test: a test connection only sees and makes test projects, which are free;
- what it may do: it can always see the account’s balance and projects. You can also let it create projects and spend credits on them, with a monthly cap in hours, and buy credits with the account’s saved card, with a monthly cap in dollars.
The assistant never sees your password. It can never do more than your own role in the account allows, and it stops working if you leave the account, sign out everywhere or change your password. See and disconnect your connected apps on your account page.
Claude Code
Section titled “Claude Code”claude mcp add --transport http podsworth https://api.podsworth.com/mcpThen run /mcp in Claude Code to sign in. Clients that can’t sign in through a browser can use an
API key instead:
claude mcp add --transport http podsworth https://api.podsworth.com/mcp \ --header "Authorization: Bearer pw_test_…"| Tool | What it does |
|---|---|
get_account |
The balance, live or test, what this connection may do, its caps and how much of them is used, and the bundles on sale. |
estimate_cost |
What files of these lengths would cost, and whether the balance covers it. Charges nothing. |
create_project |
A draft project. Files with a url (a public https link or a Dropbox share link) start importing at once; the others come back with an upload URL. |
get_upload_link |
A page for you to drop your audio files into a project the assistant created, for when the files are on your computer. It works for 24 hours. |
submit_project |
Measures the files, charges the credits and queues the project, or rejects it with a reason. |
get_project |
Status, progress, cost, estimatedCompletionAt, why it was rejected or failed. |
list_projects |
The account’s projects, newest first. |
get_downloads |
Links to a completed project’s files (valid for an hour). |
cancel_project |
Cancels before processing starts; the credits come back. |
delete_project_files |
Deletes the uploaded and processed files now. |
buy_credits |
Buys a bundle with the saved card, within the monthly cap; without that permission, returns a link for you to buy it. |
Getting audio in
Section titled “Getting audio in”Assistants in a chat usually can’t attach files from your computer to a tool call. Give them a link instead (a public https URL or a Dropbox share link), or tell them the file names: they create the project and give you an upload page (get_upload_link) where you choose each file, then submit it when you say you’re done.
Assistants that can run commands, such as Claude Code, can also upload themselves: each file in create_project’s answer has an upload.url and upload.fields; POST the fields and then the file as multipart/form-data, as in the quickstart.
Limits and money
Section titled “Limits and money”- A project costs what it would through the API; the assistant can’t go past the monthly cap you set. A submit over
the cap is rejected with
spend_cap_reached, and the project waits for you to submit it or connect the assistant again with a higher cap. - Buying over the monthly purchase cap is refused with
purchase_cap_reached. If the bank asks the cardholder to confirm a purchase, the assistant gets a link for you. - Requests count toward the same rate limits as an API key: 120 a minute per connection.