Skip to content

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/mcp

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;
  • a show, for a network’s account: limited to one, it only sees and makes that show’s projects (see Shows and usage);
  • 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.

Terminal window
claude mcp add --transport http podsworth https://api.podsworth.com/mcp

Then run /mcp in Claude Code to sign in. Clients that can’t sign in through a browser can use an API key instead:

Terminal window
claude mcp add --transport http podsworth https://api.podsworth.com/mcp \
--header "Authorization: Bearer pw_test_…"
ToolWhat it does
get_accountThe balance, live or test, what this connection may do, its caps and how much of them is used, and the bundles on sale.
estimate_costWhat files of these lengths would cost, and whether the balance covers it. Charges nothing.
create_projectA draft project (submitted too with submit). 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.
update_projectChanges a draft or rejected project’s files, name or merging, e.g. to replace a file that couldn’t be read.
get_upload_linkA 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_projectChecks the files, charges the credits and queues the project, or rejects it with a reason.
copy_projectProcesses a project again: a new project from the same files, with other settings or files, charged like any project.
get_projectStatus, progress, cost, estimatedCompletionAt, why it was rejected or failed.
list_projectsThe account’s projects, newest first; one show’s with show.
list_showsThe account’s shows, to put a project in one with create_project’s show.
list_destinationsThe account’s Drive and Dropbox folders, for create_project’s deliveries or send_project.
send_projectSends a project’s files to folders: now if it’s finished, otherwise when it finishes.
get_downloadsLinks to a completed project’s files (valid for an hour).
cancel_projectCancels before processing starts; the credits come back.
delete_project_filesDeletes the processed files, and the uploaded ones no other unfinished project uses, now.
keep_projectKeeps a project’s files past 30 days, for a fee in credits that counts toward the connection’s cap.
buy_creditsBuys a bundle with the saved card, within the monthly cap; without that permission, returns a link for you to buy it.

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 uploadUrl; PUT the file there (curl -T host.wav "<uploadUrl>"), as in the quickstart.

  • 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.
  • Plans, auto top-up and invoices are yours to set up on the account page: an assistant can’t start a plan (user_only) or change auto top-up (not_for_apps), whatever it may buy.
  • Requests count toward the same rate limits as an API key: 120 a minute per connection.