BugHerd MCP server
39 operations0 webhooks
Work with BugHerd website feedback and bug reports. List and triage tasks, move them across the board, comment, attach files, and manage projects, columns and webhooks.
Try BugHerd with your agent
Connect BugHerd, 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 BugHerd on my account, then run one read-only example and show me the result.
BugHerd tools and triggers
Tools are what your agent can do in BugHerd through Corsair's MCP server. Triggers are the BugHerd events a routine can start from.
Tasks
- CreateWrite
Create a task in a project. Without a status it lands in the Feedback panel.
tasks.create
- Create AttachmentWrite
Attach a file to a task from a public URL. BugHerd keeps a copy.
tasks.createAttachment
- Create CommentWrite
Comment on a task, optionally visible to team members only.
tasks.createComment
- DeleteDestructive
Delete a task. Cannot be undone.
tasks.delete
- Delete AttachmentDestructive
Remove an attachment from a task. Cannot be undone.
tasks.deleteAttachment
- ListRead-only
List tasks in a project, filtered by status, priority, tag, assignee, external id or date. 100 per page.
tasks.list
- List ArchivedRead-only
List closed and archived tasks in a project.
tasks.listArchived
- List AttachmentsRead-only
List the files attached to a task.
tasks.listAttachments
- List CommentsRead-only
List the comments on a task.
tasks.listComments
- List FeedbackRead-only
List tasks in the Feedback panel (new, not yet triaged).
tasks.listFeedback
- List For UserRead-only
List tasks assigned to a user across all projects.
tasks.listForUser
- List TaskboardRead-only
List the active tasks on the project taskboard.
tasks.listTaskboard
- MoveWrite
Move tasks to another project, by their #numbers.
tasks.move
- ShowRead-only
Get one task by its global id, with or without the project id.
tasks.show
- Show AttachmentRead-only
Get one attachment on a task.
tasks.showAttachment
- Show By Local IdRead-only
Get a task by the #number shown in the BugHerd UI.
tasks.showByLocalId
- UpdateWrite
Change a task: status (column), priority, assignees, tags, description.
tasks.update
- Upload AttachmentWrite
Upload a file to a task (a URL, or base64 for a small file).
tasks.uploadAttachment
Projects
- Add GuestDestructive
Add a guest (client) to a project by user id, or invite one by email. An email invite sends the person a message.
projects.addGuest
- Add MemberWrite
Add one or more organization members to a project.
projects.addMember
- CreateWrite
Create a project for a website. Members and guests are added separately.
projects.create
- DeleteDestructive
Delete a project and all its tasks. Cannot be undone.
projects.delete
- ListRead-only
List every project in the organization, active and inactive. 100 per page.
projects.list
- List ActiveRead-only
List active projects only. 100 per page.
projects.listActive
- ShowRead-only
Get one project with its members, guests and columns.
projects.show
- UpdateWrite
Change a project's name, URL or settings. Only the fields given change.
projects.update
Columns
- CreateWrite
Add a custom column at the end of a project board.
columns.create
- DeleteDestructive
Delete an empty column. Cannot be undone.
columns.delete
- ListRead-only
List the columns on a project board, built-in and custom.
columns.list
- ShowRead-only
Get one column.
columns.show
- UpdateWrite
Rename a custom column.
columns.update
Users
- ListRead-only
List everyone in the organization, members and guests.
users.list
- List GuestsRead-only
List guests (clients) across all projects.
users.listGuests
- List MembersRead-only
List team members (not guests).
users.listMembers
- List ProjectsRead-only
List the projects a user belongs to.
users.listProjects
Webhooks
- CreateWrite
Subscribe a URL to one BugHerd event, for one project or all of them.
webhooks.create
- DeleteDestructive
Remove a webhook subscription. Cannot be undone.
webhooks.delete
- ListRead-only
List the organization webhooks with their delivery counts.
webhooks.list
Organization
- ShowRead-only
Get the organization name and id.
organization.show
Connect BugHerd to Claude, ChatGPT or Cursor
- 1
Connect BugHerd in Corsair
Add your BugHerd API key once in Corsair. Corsair stores the credential encrypted and makes the BugHerd API calls for your agent, so it never goes into a prompt or a config file. Connect BugHerd
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs BugHerd. On a ChatGPT personal plan, connect BugHerd 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, BugHerd's read and write operations run right away and its 6 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/bugherd, add the BugHerd plugin, and connect with an API key. Then call methods like corsair.bugherd.api.columns.create() from your app. Corsair syncs data per tenant.
Yes. BugHerd requires an API key from your BugHerd 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 BugHerd, GitHub, Notion, Stripe, and the rest. Trigger BugHerd from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for work with BugHerd website feedback and bug reports. List and triage tasks, move them across the board, comment, attach files, and manage projects, columns and webhooks. Common builds include sync jobs, admin tooling, and agents that call BugHerd APIs from your backend. Local DB entities let you query synced BugHerd records without hitting the API on every read.
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 BugHerd 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/bugherd in the open repo. When BugHerd 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 BugHerd data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store BugHerd 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 BugHerd 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 6 destructive BugHerd operations. You can change a link's mode at hub.corsair.dev/me.