SwaggerHub MCP server
44 operations0 webhooks
Registry for API definitions, for storing, validating, comparing and publishing OpenAPI specs, domains and templates.
Try SwaggerHub with your agent
Connect SwaggerHub, 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 SwaggerHub on my account, then run one read-only example and show me the result.
SwaggerHub tools and triggers
Tools are what your agent can do in SwaggerHub through Corsair's MCP server. Triggers are the SwaggerHub events a routine can start from.
Apis
- Clone VersionWrite
Create a version that starts as a copy of an existing one
apis.cloneVersion
- CompareRead-only
Compare a definition against the stored version and list the differences
apis.compare
- DeleteDestructive
Delete an API and every version of it. There is no undo and the comments go with it
apis.delete
- Delete VersionDestructive
Delete one version of an API. The other versions stay, and there is no undo
apis.deleteVersion
- Disable NotificationsWrite
Disable every notification the caller has on one API. Nothing else about the API changes
apis.disableNotifications
- Fork VersionWrite
Fork a version into another owner and name, including another organisation
apis.forkVersion
- Get CapabilitiesRead-only
Read what the token may do with one API version, such as seeing standardization errors
apis.getCapabilities
- Get Default VersionRead-only
Read which version the API shows by default. Null when none is set
apis.getDefaultVersion
- Get DefinitionRead-only
Read the stored definition of one API version as text, optionally resolved or flattened
apis.getDefinition
- Get NotificationsRead-only
Read which notification scopes are enabled for one API, and for the caller
apis.getNotifications
- ListRead-only
List the APIs under one owner, with paging, sorting and a filter for the token user own APIs
apis.list
- List VersionsRead-only
List every version of one API, with its default version and metadata
apis.listVersions
- RenameDestructive
Rename an API. Its published URLs change, so anything pointing at the old name breaks
apis.rename
- SaveWrite
Save a definition to one API, creating the version or updating it. Answers 409 on a published version unless force is set
apis.save
- Set Default VersionWrite
Change which version the API shows by default. The version has to exist
apis.setDefaultVersion
- Set NotificationsWrite
Turn on notification scopes for one API. The body is the bare list of scopes
apis.setNotifications
Domains
- DeleteDestructive
Delete a domain and every version of it. There is no undo
domains.delete
- Delete VersionDestructive
Delete one version of a domain. The other versions stay, and there is no undo
domains.deleteVersion
- Get DefinitionRead-only
Read the stored definition of one domain version as text
domains.getDefinition
- Get VersionsRead-only
List every version of one domain
domains.getVersions
- ListRead-only
List the domains under one owner
domains.list
- SaveWrite
Save a definition to one domain, creating the version or updating it
domains.save
Comments
- CreateDestructive
Post a comment on one API version, optionally anchored to a line range. Collaborators with notifications on are told about it
comments.create
- DeleteDestructive
Delete one comment and its replies. There is no undo
comments.delete
- ListRead-only
List the comments on one API version with their replies and open or resolved status
comments.list
- ReplyDestructive
Post a reply to an existing comment. Collaborators with notifications on are told about it
comments.reply
- UpdateWrite
Change the text of one comment
comments.update
Projects
- CreateWrite
Create a project from a list of API, domain and template names that already exist in the organisation
projects.create
- DeleteDestructive
Delete a project. The APIs, domains and templates it grouped stay on the account
projects.delete
- GetRead-only
Read one project with the APIs, domains and templates it groups
projects.get
- ListRead-only
List the projects in one organisation
projects.list
- UpdateWrite
Replace a project definition. A collection left out is cleared, so send all three
projects.update
Api Settings
- Get LifecycleRead-only
Read whether one API version is published
apiSettings.getLifecycle
- Get VisibilityRead-only
Read whether one API version is private
apiSettings.getVisibility
- Set LifecycleDestructive
Publish or unpublish one API version. Publishing exposes it to everyone it is visible to
apiSettings.setLifecycle
- Set VisibilityWrite
Make one API version private or public. A private version leaves public view immediately
apiSettings.setVisibility
Templates
- DeleteDestructive
Delete one template version, or the whole template when no version is given. There is no undo
templates.delete
- GetRead-only
Read one template definition as text, optionally a built-in template
templates.get
- ListRead-only
List the template catalog, optionally narrowed to one owner, including the built-in templates
templates.list
- SaveWrite
Create or update a template and its version
templates.save
Integrations
- ExecuteDestructive
Run one integration once, which pushes the stored definition to its target such as a repository or gateway
integrations.execute
- ListRead-only
List the integrations configured on one API version, with their ids and enabled state
integrations.list
Specs
- ListRead-only
List the specs visible to the account, filtered by type, owner, visibility, state or free text
specs.list
- ValidateRead-only
Validate an OpenAPI or AsyncAPI definition and get findings with line and column positions. Nothing is saved
specs.validate
Connect SwaggerHub to Claude, ChatGPT or Cursor
- 1
Connect SwaggerHub in Corsair
Add your SwaggerHub API key once in Corsair. Corsair stores the credential encrypted and makes the SwaggerHub API calls for your agent, so it never goes into a prompt or a config file. Connect SwaggerHub
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs SwaggerHub. On a ChatGPT personal plan, connect SwaggerHub 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, SwaggerHub's read and write operations run right away and its 12 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/swaggerhub, add the SwaggerHub plugin, and connect with an API key. Then call methods like corsair.swaggerhub.api.apis.cloneVersion() from your app. Corsair keeps each tenant isolated.
Yes. SwaggerHub requires an API key from your SwaggerHub 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 SwaggerHub, GitHub, Notion, Stripe, and the rest. Trigger SwaggerHub from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for registry for API definitions, for storing, validating, comparing and publishing OpenAPI specs, domains and templates. Common builds include sync jobs, admin tooling, and agents that call SwaggerHub 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 SwaggerHub 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/swaggerhub in the open repo. When SwaggerHub 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 SwaggerHub data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store SwaggerHub 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 SwaggerHub 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 12 destructive SwaggerHub operations. You can change a link's mode at hub.corsair.dev/me.