RELATED 01
SmartBear MCP Server
OFFICIAL SERVEROne MCP server for SmartBear's BugSnag, Swagger, PactFlow, Zephyr, QMetry, Reflect and other QA tools
44GitHub stars
15k/wknpm downloads
61popularity score
Swagger Remote MCP Server
SmartBear's hosted endpoint for managing Swagger Studio APIs and Swagger Portal content
Official · smartbear.com Remote (hosted) · Streamable HTTP Developer tools
Connect your client
Remote (hosted)
Add in one click
Opens the app, which asks before it adds the server.
Or add it by command or config
VS Code.vscode/mcp.json
{
"servers": {
"smartbear-swagger": {
"type": "http",
"url": "https://swagger.mcp.smartbear.com/mcp"
}
}
}Cursormcp.json
{
"mcpServers": {
"swagger-remote": {
"url": "https://swagger.mcp.smartbear.com/mcp"
}
}
}Claude (desktop and web)Settings > Connectors (custom connector)
https://swagger.mcp.smartbear.com/mcpClaude Codeterminal
claude mcp add --transport http smartbear-swagger https://swagger.mcp.smartbear.com/mcpkiro~/.kiro/settings/mcp.json
{
"mcpServers": {
"swagger": {
"type": "http",
"url": "https://swagger.mcp.smartbear.com/mcp",
"oauth": {
"oauthScopes": []
},
"disabled": false,
"autoApprove": []
}
}
}What it does
This is the hosted version of the Swagger part of SmartBear's MCP server. Instead of running the @smartbear/mcp npm package with a Swagger API key, you point an MCP client at https://swagger.mcp.smartbear.com/mcp over streamable HTTP and sign in through a browser with your SmartBear account.
It covers two Swagger products. On the Studio side (the SwaggerHub Registry) it can search APIs and domains, fetch a definition as JSON or as its YAML source, validate and scan definitions against your organization's governance rules, create or update APIs, apply small search-and-replace patches, and generate or fix definitions with SmartBear AI. On the Portal side it lists, creates and updates portals and their products, manages sections, tables of contents and documentation pages, and publishes a product live or as a preview.
The endpoint's OAuth protected-resource metadata names https://auth.swaggerhub.com as its authorization server, so the sign-in is the SwaggerHub one rather than a generic SmartBear page. SmartBear's remote-server guide also shows that Swagger Functional Testing tools, which the local package offers with their own token, are not part of this hosted server.
What it needs
A SmartBear (SwaggerHub) account with access to Swagger Studio and, for the portal tools, Swagger Portal. An MCP client that can connect to a remote HTTP server and complete an OAuth browser sign-in. Nothing is installed locally and no Node.js or API key is needed.
Limits
Only Swagger Portal and Swagger Studio tools are served; Swagger Functional Testing, Reflect, QMetry, PactFlow and Collaborator are only in the local @smartbear/mcp package. list_portals returns only portals where you are an owner or designer. create_api_from_prompt fails if the API version already exists. patch_api accepts only OpenAPI and AsyncAPI definitions and saves nothing unless every edit applies. The docs describe on-premise base paths only for the local package; the hosted endpoint targets SmartBear's cloud.
Who it suits
Suits API teams on SwaggerHub's cloud who want an assistant to read, validate, standardize and edit API definitions, or to maintain portal documentation, without handling an API key. Since most tools can create, change, publish or delete, it suits people who already have designer or owner rights and review what is sent. Pick the local smartbear-mcp package instead for an on-premise SwaggerHub, for Functional Testing tools, or to combine Swagger with other SmartBear products in one connection; SmartBear also hosts separate BugSnag and Zephyr endpoints.
Tools 28
search_apis_and_domains- Search Studio APIs and domains and return their metadata
get_api_definition- Fetch an API definition by owner, name and version, as JSON or YAML text
create_or_update_api- Save a definition to the registry, creating the API or updating an existing one
scan_api_standardization- Check a supplied definition against the organization's governance rules
scan_api_standardization_from_registry- Run the governance scan on an API already in the registry
validate_api- Validate the structure of an OpenAPI or AsyncAPI definition
create_api_from_prompt- Generate and save a new API or version from a text prompt with SmartBear AI
standardize_api- Fix governance errors in a definition with SmartBear AI and save the result
patch_api- Apply search-and-replace edits to a stored definition's YAML source
list_organizations- List the organizations the signed-in user belongs to
list_portals- List portals where the user is an owner or designer
get_portal- Get details of one portal
create_portal- Create a new portal
update_portal- Change a portal's settings
resolve_organization_portal- Find an organization's portal and its products, creating the portal if none exists
list_portal_products- List the products in a portal
get_portal_product- Get details of one portal product
create_portal_product- Add a product to a portal
update_portal_product- Change a portal product's settings
delete_portal_product- Remove a product from a portal
publish_portal_product- Publish a product's content live or as a preview
list_portal_product_sections- List the sections of a portal product
create_table_of_contents- Add an API reference, HTML or Markdown entry to a section
list_table_of_contents- List the table of contents of a product section
delete_table_of_contents- Soft-delete a table of contents entry, optionally with its children
create_documentation_page- Add a Markdown or HTML page to a portal product in one call
get_document- Read a document's content and metadata by ID
update_document- Change the content of an existing document