Swagger MCP

com.smartbearPublished by smartbear.comOfficial publisherv0.33.0Updated Oct 24, 2026

MCP server for AI access to Swagger by SmartBear.

The publisher's own server: SmartBear MCP

VerifiedStreamable HTTPWeb executableDeveloper ToolsSecurity & Monitoring

Overview

AI-generated overview

SmartBear's hosted Swagger MCP server that gives an AI assistant OAuth-based access to Swagger API portal, Studio, contract testing and functional testing…

What you can do
  • Manage Swagger portals and products
  • Create and standardize API definitions and domains in Swagger Studio, including generating APIs from prompts
  • Work with contract testing through PactFlow
  • Discover API tests for functional testing
  • Query and manage SmartBear testing data in natural language
When to use it
Useful when you work with SwaggerHub or SmartBear API tooling and want an assistant to inspect portals, draft or standardize API definitions, or look up contract and functional test information without leaving the chat.
Requirements
A remote streamable HTTP endpoint; no installation, Node.js or API tokens needed for this hosted server. Requires a SmartBear account with access to the relevant Swagger products and an OAuth browser sign-in flow. Network access to the SmartBear endpoint.
Before you install
Sign-in is via OAuth, so the assistant acts with your SmartBear account permissions. Some tools can create or change API definitions, portals and test assets, so review write actions before approving. Requests and results go to SmartBear's hosted service.

Installation

In SourceWeft

  1. Open Swagger MCP in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.smartbear%2Fswagger-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "swagger": {
      "type": "http",
      "url": "https://swagger.mcp.smartbear.com/mcp"
    }
  }
}

README


A Model Context Protocol (MCP) server which provides AI assistants with seamless access to SmartBear's suite of testing and monitoring tools, including BearQ, BugSnag, Reflect, Swagger, PactFlow, Pact Broker, QMetry, QTM4J, Zephyr and Collaborator.

What is MCP?

The Model Context Protocol (MCP) is an open standard that enables AI assistants to securely connect to external data sources and tools. This server exposes SmartBear's APIs through natural language interfaces, allowing you to query your testing data, analyze performance metrics, and manage test automation directly from your AI workflow.

Supported Tools

See individual guides for suggested prompts and supported tools and resources:

  • BearQ - AI-powered QA test management and execution capabilities
  • BugSnag - Comprehensive error monitoring and debugging capabilities
  • Reflect - Test management and execution capabilities
  • Swagger
    • Portal - Portal and product management capabilities
    • Studio - API and Domain management capabilities, including AI-powered API generation from prompts and automatic standardization
    • Contract Testing (PactFlow) - Contract testing capabilities
    • Functional Testing - API test discovery capabilities
  • QMetry - QMetry Test Management capabilities
  • Zephyr - Zephyr Test Management capabilities
  • Collaborator - Review and Remote System Configuration management capabilities
  • QTM4J - QTM4J Test Management for Jira capabilities

Remote MCP Servers

For BugSnag, Swagger, and Zephyr, SmartBear hosts Remote MCP Servers that you can connect to directly from your MCP client via a URL — no installation, Node.js, or API tokens required. Authentication is handled through an OAuth browser flow.

ProductServer URL
Swaggerhttps://swagger.mcp.smartbear.com/mcp
BugSnaghttps://bugsnag.mcp.smartbear.com/mcp
Zephyrhttps://zephyr.mcp.smartbear.com/mcp

See the Remote MCP Servers guide for per-client setup instructions. You can connect to multiple remote servers at the same time.

Need BearQ, Reflect, QMetry, QTM4J, PactFlow, Collaborator, or Functional Testing? These products are only available via the local npm package below, which bundles all products into a single MCP server.

Prerequisites

  • Node.js 22+ and npm
  • Access to SmartBear products (BugSnag, Reflect, Swagger, QMetry, QTM4J or Zephyr)
  • Valid API tokens for the products you want to integrate

Local MCP Server Installation (npm)

For all products — or if you prefer running the server locally — the MCP server is distributed as an npm package @smartbear/mcp, making it easy to integrate into your development workflow.

The server is started with the API key or auth token that you use with your SmartBear product(s). They are optional and can be removed from your configuration if you aren't using the product. For BugSnag, if you provide a project API key it will narrow down all searches to a single project in your BugSnag dashboard. Leave this field blank if you wish to interact across multiple projects at a time.

VS Code with Copilot

For the quickest setup, use the "MCP: Add server…" command in the Command Palette to add the @smartbear/mcp npm package.

📋 Manual installation

Alternatively, you can use npx (or globally install) the @smartbear/mcp package to run the server and add the following to your .vscode/mcp.json file:

json
{  "servers": {    "smartbear": {      "type": "stdio",      "command": "npx",      "args": [        "-y",        "@smartbear/mcp@latest"      ],      "env": {        "BEARQ_API_TOKEN": "${input:bearq_api_token}",        "BEARQ_API_BASE_URL": "${input:bearq_api_base_url}",        "BUGSNAG_AUTH_TOKEN": "${input:bugsnag_auth_token}",        "BUGSNAG_PROJECT_API_KEY": "${input:bugsnag_project_api_key}",        "REFLECT_API_TOKEN": "${input:reflect_api_token}",        "SWAGGER_API_KEY": "${input:swagger_api_key}",        "SWAGGER_PORTAL_BASE_PATH": "${input:swagger_portal_base_path}",        "SWAGGER_REGISTRY_BASE_PATH": "${input:swagger_registry_base_path}",        "SWAGGER_UI_BASE_PATH": "${input:swagger_ui_base_path}",        "PACT_BROKER_BASE_URL": "${input:pact_broker_base_url}",        "PACT_BROKER_TOKEN": "${input:pact_broker_token}",        "PACT_BROKER_USERNAME": "${input:pact_broker_username}",        "PACT_BROKER_PASSWORD": "${input:pact_broker_password}",        "QMETRY_API_KEY": "${input:qmetry_api_key}",        "QMETRY_BASE_URL": "${input:qmetry_base_url}",        "ZEPHYR_API_TOKEN": "${input:zephyr_api_token}",        "ZEPHYR_BASE_URL": "${input:zephyr_base_url}",        "COLLABORATOR_BASE_URL": "${input:collab_base_url}",        "COLLABORATOR_USERNAME": "${input:collab_username}",        "COLLABORATOR_LOGIN_TICKET": "${input:collab_login_ticket}",        "QTM4J_API_KEY": "${input:qtm4j_api_key}",        "QTM4J_BASE_URL": "${input:qtm4j_base_url}",        "QTM4J_AUTOMATION_API_KEY": "${input:qtm4j_automation_api_key}",        "SWAGGER_FUNCTIONAL_TESTING_API_TOKEN": "${input:swagger_functional_testing_api_token}",        "SWAGGER_FUNCTIONAL_TESTING_BASE_PATH": "${input:swagger_functional_testing_base_path}"      }    }  },  "inputs": [      {         "id": "bearq_api_token",         "type": "promptString",         "description": "BearQ workspace API token - leave blank to disable BearQ tools",         "password": true      },      {         "id": "bearq_api_base_url",         "type": "promptString",         "description": "BearQ API base URL - leave blank to use the default (https://api.bearq.smartbear.com)",         "password": false      },      {         "id": "bugsnag_auth_token",         "type": "promptString",         "description": "BugSnag Auth Token - leave blank to disable BugSnag tools",         "password": true      },      {         "id": "bugsnag_project_api_key",         "type": "promptString",         "description": "BugSnag Project API Key - for single project interactions",         "password": false      },      {         "id": "reflect_api_token",         "type": "promptString",         "description": "Reflect API Token - leave blank to disable Reflect tools",         "password": true      },      {         "id": "swagger_api_key",         "type": "promptString",         "description": "Swagger API Key - leave blank to disable Swagger tools",         "password": true      },      {         "id": "swagger_portal_base_path",         "type": "promptString",         "description": "Swagger Portal API base path - only needed for on-premise installations (leave blank for cloud)",         "password": false      },      {         "id": "swagger_registry_base_path",         "type": "promptString",         "description": "Swagger Registry API base path - only needed for on-premise installations (leave blank for cloud)",         "password": false      },      {         "id": "swagger_ui_base_path",         "type": "promptString",         "description": "Swagger UI base path - only needed for on-premise installations (leave blank for cloud)",         "password": false      },      {         "id": "pact_broker_base_url",         "type": "promptString",         "description": "PactFlow or Pact Broker base url - leave blank to disable the tools",         "password": true      },      {         "id": "pact_broker_token",         "type": "promptString",         "description": "PactFlow Authentication Token",         "password": true      },      {         "id": "pact_broker_username",         "type": "promptString",         "description": "Pact Broker Username",         "password": true      },      {         "id": "pact_broker_password",         "type": "promptString",         "description": "Pact Broker Password",         "password": true      },      {          "id": "qmetry_api_key",          "type": "promptString",          "description": "QMetry Open API Key",          "password": true      },      {          "id": "qmetry_base_url",          "type": "promptString",          "description": "By default, connects to https://testmanagement.qmetry.com. Change to a custom QMetry server URL or a region-specific endpoint if needed.",          "password": false      },      {          "id": "zephyr_api_token",          "type": "promptString",          "description": "Zephyr API token - leave blank to disable Zephyr tools",          "password": true      },      {          "id": "zephyr_base_url",          "type": "promptString",          "description": "Zephyr API base URL. By default, connects to https://api.zephyrscale.smartbear.com/v2. Change to region-specific endpoint if needed.",          "password": false      },      {          "id": "collab_base_url",          "type": "promptString",          "description": "Collab base url",          "password": true      },      {          "id": "collab_username",          "type": "promptString",          "description": "Collab username",          "password": true      },      {          "id": "collab_login_ticket",          "type": "promptString",          "description": "Collab login ticket",          "password": true      },      {          "id": "qtm4j_api_key",          "type": "promptString",          "description": "QTM4J API Key",          "password": true    },    {          "id": "qtm4j_base_url",          "type": "promptString",          "description": "US region (default): https://qtmcloud.qmetry.com. Australia region: https://syd-qtmcloud.qmetry.com.",          "password": false    },    {          "id": "qtm4j_automation_api_key",          "type": "promptString",          "description": "QTM4J Automation API Key - required for automation tools, leave blank to disable them",          "password": true    },    {          "id": "swagger_functional_testing_api_token",          "type": "promptString",          "description": "Swagger Functional Testing API Token - leave blank to disable Functional Testing tools",          "password": true    },    {          "id": "swagger_functional_testing_base_path",          "type": "promptString",          "description": "Swagger Functional Testing API Base URL - leave blank to use the default (https://api.reflect.run/v1)",          "password": false    }  ]}

Claude Desktop

Add the following configuration to your claude_desktop_config.json to launch the MCP server via npx:

json
{  "mcpServers": {    "smartbear": {      "command": "npx",      "args": [        "-y",        "@smartbear/mcp@latest"      ],      "env": {        "BEARQ_API_TOKEN": "your_bearq_api_token",        "BUGSNAG_AUTH_TOKEN": "your_personal_auth_token",        "BUGSNAG_PROJECT_API_KEY": "your_project_api_key",        "REFLECT_API_TOKEN": "your_reflect_token",        "SWAGGER_API_KEY": "your_swagger_key",        "SWAGGER_PORTAL_BASE_PATH": "https://api.portal.swaggerhub.com/v1",        "SWAGGER_REGISTRY_BASE_PATH": "https://api.swaggerhub.com",        "SWAGGER_UI_BASE_PATH": "https://app.swaggerhub.com",        "PACT_BROKER_BASE_URL": "your_pactflow_or_pactbroker_base_url",        "PACT_BROKER_TOKEN": "your_pactflow_token",        "PACT_BROKER_USERNAME": "your_pact_broker_username",        "PACT_BROKER_PASSWORD": "your_pact_broker_password",        "QMETRY_API_KEY": "your_qmetry_api_key",        "QMETRY_BASE_URL": "https://testmanagement.qmetry.com",        "ZEPHYR_API_TOKEN": "your_zephyr_api_token",        "ZEPHYR_BASE_URL": "https://api.zephyrscale.smartbear.com/v2",        "COLLABORATOR_BASE_URL": "your collab base url",        "COLLABORATOR_USERNAME": "your collab user name",        "COLLABORATOR_LOGIN_TICKET": "your collab login ticket",        "QTM4J_API_KEY": "your_qtm4j_key",        "QTM4J_BASE_URL": "https://qtmcloud.qmetry.com",        "QTM4J_AUTOMATION_API_KEY": "your_qtm4j_automation_api_key",        "SWAGGER_FUNCTIONAL_TESTING_API_TOKEN": "your_swagger_functional_testing_api_token",        "SWAGGER_FUNCTIONAL_TESTING_BASE_PATH": "https://api.reflect.run/v1"      }    }  }}

Loading only the products you use

Set MCP_CLIENTS to a comma-separated, case-insensitive list of product names (for example "MCP_CLIENTS": "QMetry") to load only those products. This reduces startup time, which helps on clients with a short initialize timeout. Valid names are BearQ, BugSnag, Collaborator, Contract Testing, QMetry, QTM4J, Reflect, Swagger and Zephyr. When unset, all products are loaded.

Server Configuration (HTTP mode)

VariableDefaultPurpose
BASE_URL(derived from request)The server's own public URL, e.g. https://mcp.example.com. Set this on any deployment behind a proxy or load balancer — otherwise the address advertised for OAuth discovery is derived from the client-supplied Host header.
TRUST_PROXYfalseSet to true only when a proxy in front of the server sets X-Forwarded-Host and strips any client-supplied value.
MCP_SERVER_AMPLITUDE_API_KEY(unset — analytics off)API key for the shared SmartBear Amplitude project. When set, the server reports Server Initialized, Session Started, Session Ended, Tool Called and Tools Listed usage events (tool outcome and timing only — never tool arguments, results, credentials or raw email). Unset, nothing is tracked. HTTP mode only.

Documentation

For detailed introduction, examples, and advanced configuration visit our 📖 Full Documentation

Local Development

For developers who want to contribute to the SmartBear MCP server, please see the CONTRIBUTING.md guide.

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

Support

SmartBear MCP Server - Bringing the power of SmartBear's testing and monitoring ecosystem to your AI-powered development workflow.

Source: README.md at commit d7b0663

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v0.33.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Smartbear integrations

SmartBear MCP

com.smartbearOfficial publisher

SmartBear MCP gives an AI assistant access to SmartBear testing and monitoring products such as BugSnag, BearQ, Swagger, PactFlow, QTM4J, Zephyr and…

Streamable HTTPWeb executableAuth
Productivity & Workflow200+ toolsNov 7, 2026