Skip to main content
Vespin MCP offers these tools to any agent you connect. Each acts as you, with your permissions, so it allows and refuses exactly what the app does. To connect an agent, see MCP. Each tool answers JSON text. A refusal comes back marked as an error, with status: "rejected" and why. A tool that lists, makes, or changes something of a workspace takes its slug as workspace, from list_workspaces, even where you belong to only one. A call that names a task, agent, or automation by its id may leave it out, since the id settles the workspace.

Workspaces and members

list_workspaces

Your workspaces: each one’s id, slug, name, and your role. Call it first. No inputs.

create_workspace

Creates a workspace you own.

list_workspace_members

The workspace’s members, owners first, with each one’s role, and former members.

rename_workspace

Renames the workspace. Owners and admins only; your first workspace keeps its name.

set_workspace_slug

Changes the workspace’s slug. Old links keep working. Owners only.

set_workspace_photo

Sets or removes the workspace’s photo. Owners and admins only.

invite_to_workspace

Invites an email address. The invitation expires after 48 hours. Only the owner can invite an admin.

list_workspace_invitations

Pending invitations, with their accept links. Owners and admins only.

cancel_workspace_invitation

Cancels a pending invitation. Owners and admins only.

change_workspace_member_role

Makes a member an admin or a member. Owners only.

remove_workspace_member

Removes a member. An owner removes admins and members; an admin removes members.

Tasks

list_tasks

The workspace’s tasks, newest first, 50 a page, and your sidebar sections.

read_task

One task, by its id or its key, such as ACME-42: its key, status, priority, repository, assignee, blockers, and brief.

create_task

Creates a task you own, with no agent on it.

update_task

Changes a task’s name, repository, status, priority, assignee, pin, section, parent, or blocks. Marking it done or canceled withdraws its open asks and archives its agents: idle ones at once, and working ones as their turns end. Moving it off done or canceled brings those agents back, but their asks stay withdrawn.

change_task_relation

Turns one relation between two tasks into another kind, in one step.

delete_task

Deletes a task for good. Its sub-tasks stay, moved to the top level. It stops no agent: while one of its agents is starting or running it is refused, and stop_agent stops each first.

create_section

Adds a section to your sidebar.

delete_section

Deletes a sidebar section. Its tasks go back under Tasks.

read_page

Reads a page an agent showed on a task: its title, version, and HTML.

read_task_file

Reads a file of the task’s repository on GitHub, up to 500 lines at a time. Never reads the agent’s sandbox.

list_task_folder

Lists a folder of the task’s repository on GitHub.

Agents

list_agents

Agents, newest first, 50 a page, with each one’s status, model, branch, and task.

read_agent

One agent: what list_agents says of it, and the messages waiting in its queue. Its transcript is read_agent_transcript’s, and its branch and pull request read_agent_changes’. The agent isn’t told.

read_agent_transcript

An agent’s whole transcript, a page at a time, one worker’s transcript, or one call in full.

read_agent_changes

The agent’s pull request: its state, checks, reviewers, and changed files, or one file’s patch.

start_agent

Starts an agent on a task, or from another agent on its task. Make a new task first with create_task. Answers once its session opens, which can take a minute or two. The agent doesn’t report back to the caller. No start names who pays: each turn of a cloud agent runs on the first of your subscriptions and API keys for the model’s provider that has room (where none has, your first API key, or with no key the subscription whose limit resets soonest), and moves to the next when one hits its limit, which can switch between a subscription and a key. An agent on a device runs on that machine’s own login, whatever you keep.

message_agent

Sends an agent a message as you, or queues it behind the agent’s turn.

change_agent_queue

Resumes, holds, edits, deletes, reorders, or steers the messages queued for an agent. On an idle agent, every change except a delete sends the next message at once.

stop_agent

Stops the agent’s turn. Its work so far stands. Every stop also cancels a wakeup the agent booked and pauses its queue until change_agent_queue resumes it, even when the agent was already idle.

update_agent

Changes an agent’s title, model, effort, context window, pin, or MCP servers, or archives it.

rewind_agent

Takes an agent back to the moment before one of its lines, deleting the workers it started since. Its checkout stays as it is. It stops no turn: an agent starting or running is refused, and stop_agent stops it first. It does cancel a wakeup the agent booked.

delete_agent

Deletes an agent for good. Its branch and pull request stay on GitHub. It stops nothing: an agent starting or running is refused, and stop_agent stops it first.

wake_agent

Resumes a cloud agent’s sandbox.

list_agent_ports

The ports listening in a cloud agent’s sandbox, and the one shared.

share_agent_port

Shares one port of a cloud agent’s sandbox by link, or stops sharing.

list_agent_browser_tabs

The tabs in a cloud agent’s browser, with who drives each.

open_agent_browser_tab

Opens an address in the agent’s browser and takes the tab over for you.

take_over_agent_browser_tab

Takes a tab over, so the agent waits until you hand it back or 60 seconds pass.

hand_back_agent_browser_tab

Hands a tab back to the agent.

run_action

Runs one of the repository’s run actions in a cloud agent’s sandbox.

stop_run_action

Stops a run action.

list_models

The models you’re offered, with their efforts, the kinds of credential that pay for each (subscription, API key, both, or none), and your default. No inputs.

update_preferences

Sets the model, effort, and context window your agents start on.

Inbox

read_inbox

Your threads: asks waiting on you first, then other open threads, then the latest 20 settled.

answer_ask

Answers an open ask as you: a choice, a to-do’s done or not done, a form, or words. If this settles the last thing an automation run with Mark finished runs Done is waiting on, the run’s agents are archived and its task moves to Done.

acknowledge_thread

Acknowledges a notice, as Got it does. If this settles the last thing an automation run with Mark finished runs Done is waiting on, the run’s agents are archived and its task moves to Done.

reply_to_thread

Writes on a thread without answering its ask.

close_thread

Closes a thread without answering it. If this settles the last thing an automation run with Mark finished runs Done is waiting on, the run’s agents are archived and its task moves to Done.

mark_thread_read

Marks a thread read or unread, for you only.

mark_inbox_read

Marks every thread read.

remind_thread

Hides a thread until a time, or ends its reminder.

start_thread

Starts a new thread with an agent.

Pull requests

read_pull_request

Reads one part of a pull request: its overview, checks, conversation, or changes.

agent_pull_request_action

Makes one change on GitHub as you: merge, auto-merge, review, comment, label, and the rest.

mark_pull_request_files_viewed

Marks files viewed or not viewed.

read_pull_request_chapters

Reads a pull request’s chapters.

generate_pull_request_chapters

Generates chapters on your own key of the provider you name, Anthropic or OpenAI, which you pay for.

Comments on pages

read_comments

The comment threads on one of a task’s pages.

reply_to_comment

Replies in a thread. Every agent in it is sent the reply.

update_comment

Resolves or reopens a thread.

Repositories and GitHub

list_repositories

The repositories the workspace reaches through the GitHub App or members’ tokens.

set_token_repository

Adds or removes a repository on your own GitHub token.

read_repository_file

Reads a file of a repository on GitHub.

list_repository_folder

Lists a folder of a repository on GitHub.

read_github_issue

Reads an issue or pull request’s title, state, and author.

read_github_connection

Whether your GitHub is connected, and as whom. No inputs.

list_repository_pins

The repositories you pinned. No inputs.

pin_repository

Pins or unpins a repository.

Cloud environment

read_sandbox_setup

The workspace’s install script, each repository’s setup script, and its run actions.

edit_sandbox_setup

Replaces the install script or a repository’s setup script. Owners and admins only.

edit_run_action

Adds, changes, or removes a repository’s run action. Owners and admins only.

list_environment_variables

The workspace’s environment variables, by name. Never their values.

set_environment_variable

Sets an environment variable. Owners and admins only. The value is never shown again.

delete_environment_variable

Deletes an environment variable. Owners and admins only.

Automations

list_automations

The workspace’s automations, or one in full with its runs.

create_automation

Creates an automation on a schedule, a GitHub event, or a Sentry event. Webhook triggers are made in the app.

update_automation

Changes an automation. A new trigger replaces the old one whole.

run_automation

Runs an automation now.

delete_automation

Deletes an automation.

Integrations, Slack, and Sentry

list_integrations

Your integrations. Never their tokens. No inputs.

connect_integration

Answers a link that connects an integration, for you to open in your browser.

list_integration_tools

The tools one of your integrations gives agents.

rename_integration

Renames one of your integrations.

disconnect_integration

Disconnects an integration.

read_slack_bot

The workspace’s Slack bot: its default repository, channels, and your notifications.

update_slack_bot

Changes your Slack notifications, or the bot’s repository and channels (owners and admins).

disconnect_slack_bot

Disconnects the Slack bot. Owners and admins only.

list_sentry_installations

The workspace’s Sentry installations.

disconnect_sentry

Disconnects a Sentry installation. Owners and admins only.

MCP clients

list_mcp_clients

The apps connected to your account through Vespin MCP, and the server’s address. No inputs.

revoke_mcp_client

Disconnects an app. Its access ends within 15 minutes.