MCP tools
MCP (Model Context Protocol) lets an AI agent, such as Claude Code or Codex, use tabletop for you. When you connect an agent, it gets the tools on this page. To connect one, see Connect Claude Code or Codex.
- An agent can use a tool only if its sign-in or its API token has the scope of the tool.
runs.startandruns.approverun nodes, so they can cost tokens.workflows.deletemoves a workflow to the trash. You can take it out of the trash for 30 days.- Each tool is also a CLI command.
Activity
| Tool | What it does | Token scope |
|---|---|---|
activity.list | List the activity of an org: runs, workflows made and deleted, and member changes. | Read workflows |
Workflows
| Tool | What it does | Token scope |
|---|---|---|
workflows.browse | List and search the workflows of each of your orgs. | Read workflows |
workflows.list | List and search the workflows. | Read workflows |
workflows.get | Get a workflow. | Read workflows |
workflows.create | Make an empty workflow. | Change workflows |
workflows.rename | Rename a workflow. | Change workflows |
workflows.duplicate | Copy a workflow. | Change workflows |
workflows.delete | Move a workflow to the trash for 30 days. | Change workflows |
workflows.restore | Take a workflow out of the trash. | Change workflows |
workflows.import | Make a workflow from a workflow file. | Change workflows |
workflows.edit_graph | Add, link, change and remove nodes of a workflow. | Change workflows |
workflows.export | Get a workflow as a workflow file. | Read workflows |
Templates
| Tool | What it does | Token scope |
|---|---|---|
starters.list | List the templates that you can copy into your org. | Read workflows |
starters.use | Copy a template into your org with the result of each node. | Change workflows |
Runs
| Tool | What it does | Token scope |
|---|---|---|
runs.start | Run a workflow, or some of its nodes with the nodes they need. | Start runs |
runs.quote | Get the most tokens that a run of a workflow holds. | Start runs |
runs.get | Get a run with the state and outputs of each node run. | Read workflows |
runs.list | List the runs of a workflow, newest first. | Read workflows |
runs.latest | Get the node run that each node of a workflow shows: a running one, else its newest result. | Read workflows |
runs.versions | List the versions of a node of a workflow, newest first. | Read workflows |
runs.use_version | Make the outputs of a node run the current versions of its node. The next run takes them. | Change workflows |
runs.cancel | Cancel a run: waiting nodes end at once, running nodes stop. | Start runs |
runs.node_run | Get a node run with its state and outputs. | Read workflows |
runs.log | Read the log of a node run. | Read workflows |
runs.approve | Approve a node run that waits for approval, so the nodes after it run. | Start runs |
Billing
| Tool | What it does | Token scope |
|---|---|---|
billing.wallet | Get the tokens of an org: balance, held and debt. | Read billing |
Last updated on