Tave MCP server
29 operations0 webhooks
Studio management with Tave, the VSCO Workspace API - manage jobs and their stages, the product price list, payments against a job, tasks and notes, and read the job types, lead sources and brands they reference.
Try Tave with your agent
Connect Tave, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.
Using Corsair, show me what you can do in Tave on my account, then run one read-only example and show me the result.
Tave tools and triggers
Tools are what your agent can do in Tave through Corsair's MCP server. Triggers are the Tave events a routine can start from.
Payments
- CreateWrite
Record a payment against a job, which changes that job balance
payments.create
- DeleteDestructive
Delete a payment, which removes it from the job balance
payments.delete
- GetRead-only
Read one payment with its refunded amount and memo
payments.get
- ListRead-only
List payments with their job, amount, status and method
payments.list
- UpdateWrite
Change a payment's status, memo, method or payer; the amount is read-only, so to fix it delete the payment and record it again (the delete cannot be undone and the new payment gets a new id)
payments.update
Products
- CreateWrite
Add a product to the price list
products.create
- DeleteDestructive
Delete a product; orders that already include it keep their line item
products.delete
- GetRead-only
Read one product with its price, SKU and flags
products.get
- ListRead-only
List the products in your price list
products.list
- UpdateWrite
Change a product's name, price, SKU or flags
products.update
Tasks
- CreateWrite
Create a task in a task list, optionally on a job
tasks.create
- DeleteDestructive
Permanently delete a task
tasks.delete
- ListRead-only
List tasks with their list, assignee and due date
tasks.list
- UpdateWrite
Change a task's name, assignee, due date or completed state
tasks.update
Notes
- CreateWrite
Add an HTML note to a job or a contact
notes.create
- DeleteDestructive
Permanently delete a note
notes.delete
- ListRead-only
List notes, optionally only those on one job
notes.list
Brands
- ListRead-only
List the brands of the studio
brands.list
Job Types
- ListRead-only
List the job types, whose IDs jobs.create takes
jobTypes.list
Lead Sources
- ListRead-only
List the lead sources, for reporting where a lead came from
leadSources.list
Lead Statuses
- ListRead-only
List the lead statuses, whose IDs jobs.list filters by
leadStatuses.list
Studio
- GetRead-only
Read the studio profile, including its currency and timezone
studio.get
Task Lists
- ListRead-only
List the task lists, whose IDs tasks.create takes
taskLists.list
Jobs
- CreateWrite
Create a lead or job with its type, lead source, brand and event date
jobs.create
- DeleteDestructive
Permanently delete a job with its orders, invoices and notes
jobs.delete
- GetRead-only
Read one job with its contacts, orders, invoices and totals
jobs.get
- ListRead-only
List jobs with their stage, balances and event dates, filtered by stage, lead status or event date range
jobs.list
- PaymentsRead-only
List the payments recorded against one job
jobs.payments
- UpdateWrite
Change a job's stage, dates, type, lead source, brand or closed state
jobs.update
Connect Tave to Claude, ChatGPT or Cursor
- 1
Connect Tave in Corsair
Add your Tave API key once in Corsair. Corsair stores the credential encrypted and makes the Tave API calls for your agent, so it never goes into a prompt or a config file. Connect Tave
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs Tave. On a ChatGPT personal plan, connect Tave here first.
- 2
Add Corsair's MCP server to your agent
Every client uses the same address:
https://mcp.corsair.dev/mcpOpen Customize → Connectors → Add custom connector, paste the address, then select Connect.Add a custom MCP server with the address and choose OAuth. Personal plans get read tools only.Add to CursorOr add this to~/.cursor/mcp.json. Cursor opens Corsair to sign in the first time it connects.{ "mcpServers": { "corsair": { "url": "https://mcp.corsair.dev/mcp" } } }Run this, then run/mcpin Claude Code to sign in.claude mcp add --transport http corsair https://mcp.corsair.dev/mcpCodex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client
- 3
Sign in and choose what needs your approval
Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. In the default Cautious mode, Tave's read and write operations run right away and its 5 destructive operations wait for your approval. Strict mode asks before every write and refuses destructive operations, and Read mode allows reads only.
FAQ
Install corsair and @corsair-dev/tave, add the Tave plugin, and connect with an API key. Then call methods like corsair.tave.api.brands.list() from your app. Corsair keeps each tenant isolated.
Yes. Tave requires an API key from your Tave account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.
Yes. One Corsair client can hit Tave, GitHub, Notion, Stripe, and the rest. Trigger Tave from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for studio management with Tave, the VSCO Workspace API - manage jobs and their stages, the product price list, payments against a job, tasks and notes, and read the job types, lead sources and brands they reference. Common builds include sync jobs, admin tooling, and agents that call Tave APIs from your backend.
The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per Tave API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.
We maintain @corsair-dev/tave in the open repo. When Tave ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.
No. Corsair does not read your Tave data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store Tave data on your behalf.
Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.
Yes. Put Tave on a link in Strict mode and every write waits for your approval, while destructive actions are refused. The default Cautious mode asks only before the 5 destructive Tave operations. You can change a link's mode at hub.corsair.dev/me.