Connects AI assistants to SmartBear testing and monitoring tools for querying test data and managing QA workflows.
Also known as SmartBear/smartbear-mcp, smartbear-mcp, @smartbear/mcp
- Stars
- 44
- Tools
- 1
- Downloads, 30 days
- —
- Latest version
- 0.44.0
- Last commit
- Nov 13, 2026
- License
- MIT
What is SmartBear MCP?
SmartBear connects AI assistants to SmartBear testing and monitoring tools for querying test data and managing QA workflows. It exposes 1 tool, such as smartbear_list_integrations.
Summary generated from the project's README
About SmartBear MCP server
Connecting AI assistants to your quality assurance ecosystem is what SmartBear MCP enables for developers and QA engineers. This server allows users to query test data, analyze performance metrics, and manage automation workflows through natural language interfaces. It bridges the gap between AI models and a wide range of testing and monitoring products, including BugSnag, Swagger, Zephyr, and QMetry.
Users can choose between two integration methods. For BugSnag, Swagger, and Zephyr, you can connect to remote MCP servers via a URL using OAuth browser authentication, which requires no local installation or API tokens. For other products like BearQ, Reflect, PactFlow, Collaborator, and QTM4J, you must install the local npm package. This local setup requires Node.js 22+ and specific API tokens or credentials for each product you wish to access within your AI workflow.
Written from the project's README. Every use case is checked against a quote from it.
How to install SmartBear MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall SmartBear MCP in Claude Code
$ claude mcp add --env 'BEARQ_API_TOKEN=<YOUR_BEARQ_API_TOKEN>' --env 'BUGSNAG_AUTH_TOKEN=<YOUR_BUGSNAG_AUTH_TOKEN>' --env 'PACT_BROKER_PASSWORD=<YOUR_PACT_BROKER_PASSWORD>' --env 'PACT_BROKER_TOKEN=<YOUR_PACT_BROKER_TOKEN>' --env 'QTM4J_API_KEY=<YOUR_QTM4J_API_KEY>' --env 'QTM4J_AUTOMATION_API_KEY=<YOUR_QTM4J_AUTOMATION_API_KEY>' --env 'REFLECT_API_TOKEN=<YOUR_REFLECT_API_TOKEN>' --env 'SWAGGER_API_KEY=<YOUR_SWAGGER_API_KEY>' --env 'SWAGGER_FUNCTIONAL_TESTING_API_TOKEN=<YOUR_SWAGGER_FUNCTIONAL_TESTING_API_TOKEN>' --env 'ZEPHYR_API_TOKEN=<YOUR_ZEPHYR_API_TOKEN>' smartbear-mcp -- npx -y @smartbear/mcpInstall SmartBear MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"smartbear-mcp": {
"command": "npx",
"args": [
"-y",
"@smartbear/mcp"
],
"env": {
"BEARQ_API_TOKEN": "<YOUR_BEARQ_API_TOKEN>",
"BUGSNAG_AUTH_TOKEN": "<YOUR_BUGSNAG_AUTH_TOKEN>",
"PACT_BROKER_PASSWORD": "<YOUR_PACT_BROKER_PASSWORD>",
"PACT_BROKER_TOKEN": "<YOUR_PACT_BROKER_TOKEN>",
"QTM4J_API_KEY": "<YOUR_QTM4J_API_KEY>",
"QTM4J_AUTOMATION_API_KEY": "<YOUR_QTM4J_AUTOMATION_API_KEY>",
"REFLECT_API_TOKEN": "<YOUR_REFLECT_API_TOKEN>",
"SWAGGER_API_KEY": "<YOUR_SWAGGER_API_KEY>",
"SWAGGER_FUNCTIONAL_TESTING_API_TOKEN": "<YOUR_SWAGGER_FUNCTIONAL_TESTING_API_TOKEN>",
"ZEPHYR_API_TOKEN": "<YOUR_ZEPHYR_API_TOKEN>"
}
}
}
}Install SmartBear MCP in VS Code
.vscode/mcp.json
{
"servers": {
"smartbear-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@smartbear/mcp"
],
"env": {
"BEARQ_API_TOKEN": "<YOUR_BEARQ_API_TOKEN>",
"BUGSNAG_AUTH_TOKEN": "<YOUR_BUGSNAG_AUTH_TOKEN>",
"PACT_BROKER_PASSWORD": "<YOUR_PACT_BROKER_PASSWORD>",
"PACT_BROKER_TOKEN": "<YOUR_PACT_BROKER_TOKEN>",
"QTM4J_API_KEY": "<YOUR_QTM4J_API_KEY>",
"QTM4J_AUTOMATION_API_KEY": "<YOUR_QTM4J_AUTOMATION_API_KEY>",
"REFLECT_API_TOKEN": "<YOUR_REFLECT_API_TOKEN>",
"SWAGGER_API_KEY": "<YOUR_SWAGGER_API_KEY>",
"SWAGGER_FUNCTIONAL_TESTING_API_TOKEN": "<YOUR_SWAGGER_FUNCTIONAL_TESTING_API_TOKEN>",
"ZEPHYR_API_TOKEN": "<YOUR_ZEPHYR_API_TOKEN>"
}
}
}
}Install SmartBear MCP in VS Code CLI
$ code --add-mcp '{"name":"smartbear-mcp","type":"stdio","command":"npx","args":["-y","@smartbear/mcp"],"env":{"BEARQ_API_TOKEN":"<YOUR_BEARQ_API_TOKEN>","BUGSNAG_AUTH_TOKEN":"<YOUR_BUGSNAG_AUTH_TOKEN>","PACT_BROKER_PASSWORD":"<YOUR_PACT_BROKER_PASSWORD>","PACT_BROKER_TOKEN":"<YOUR_PACT_BROKER_TOKEN>","QTM4J_API_KEY":"<YOUR_QTM4J_API_KEY>","QTM4J_AUTOMATION_API_KEY":"<YOUR_QTM4J_AUTOMATION_API_KEY>","REFLECT_API_TOKEN":"<YOUR_REFLECT_API_TOKEN>","SWAGGER_API_KEY":"<YOUR_SWAGGER_API_KEY>","SWAGGER_FUNCTIONAL_TESTING_API_TOKEN":"<YOUR_SWAGGER_FUNCTIONAL_TESTING_API_TOKEN>","ZEPHYR_API_TOKEN":"<YOUR_ZEPHYR_API_TOKEN>"}}'Install SmartBear MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"smartbear-mcp": {
"command": "npx",
"args": [
"-y",
"@smartbear/mcp"
],
"env": {
"BEARQ_API_TOKEN": "<YOUR_BEARQ_API_TOKEN>",
"BUGSNAG_AUTH_TOKEN": "<YOUR_BUGSNAG_AUTH_TOKEN>",
"PACT_BROKER_PASSWORD": "<YOUR_PACT_BROKER_PASSWORD>",
"PACT_BROKER_TOKEN": "<YOUR_PACT_BROKER_TOKEN>",
"QTM4J_API_KEY": "<YOUR_QTM4J_API_KEY>",
"QTM4J_AUTOMATION_API_KEY": "<YOUR_QTM4J_AUTOMATION_API_KEY>",
"REFLECT_API_TOKEN": "<YOUR_REFLECT_API_TOKEN>",
"SWAGGER_API_KEY": "<YOUR_SWAGGER_API_KEY>",
"SWAGGER_FUNCTIONAL_TESTING_API_TOKEN": "<YOUR_SWAGGER_FUNCTIONAL_TESTING_API_TOKEN>",
"ZEPHYR_API_TOKEN": "<YOUR_ZEPHYR_API_TOKEN>"
}
}
}
}Install SmartBear MCP in Codex
$ codex mcp add smartbear-mcp --env 'BEARQ_API_TOKEN=<YOUR_BEARQ_API_TOKEN>' --env 'BUGSNAG_AUTH_TOKEN=<YOUR_BUGSNAG_AUTH_TOKEN>' --env 'PACT_BROKER_PASSWORD=<YOUR_PACT_BROKER_PASSWORD>' --env 'PACT_BROKER_TOKEN=<YOUR_PACT_BROKER_TOKEN>' --env 'QTM4J_API_KEY=<YOUR_QTM4J_API_KEY>' --env 'QTM4J_AUTOMATION_API_KEY=<YOUR_QTM4J_AUTOMATION_API_KEY>' --env 'REFLECT_API_TOKEN=<YOUR_REFLECT_API_TOKEN>' --env 'SWAGGER_API_KEY=<YOUR_SWAGGER_API_KEY>' --env 'SWAGGER_FUNCTIONAL_TESTING_API_TOKEN=<YOUR_SWAGGER_FUNCTIONAL_TESTING_API_TOKEN>' --env 'ZEPHYR_API_TOKEN=<YOUR_ZEPHYR_API_TOKEN>' -- npx -y @smartbear/mcpInstall SmartBear MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.smartbear-mcp] command = "npx" args = ["-y", "@smartbear/mcp"] [mcp_servers.smartbear-mcp.env] BEARQ_API_TOKEN = "<YOUR_BEARQ_API_TOKEN>" BUGSNAG_AUTH_TOKEN = "<YOUR_BUGSNAG_AUTH_TOKEN>" PACT_BROKER_PASSWORD = "<YOUR_PACT_BROKER_PASSWORD>" PACT_BROKER_TOKEN = "<YOUR_PACT_BROKER_TOKEN>" QTM4J_API_KEY = "<YOUR_QTM4J_API_KEY>" QTM4J_AUTOMATION_API_KEY = "<YOUR_QTM4J_AUTOMATION_API_KEY>" REFLECT_API_TOKEN = "<YOUR_REFLECT_API_TOKEN>" SWAGGER_API_KEY = "<YOUR_SWAGGER_API_KEY>" SWAGGER_FUNCTIONAL_TESTING_API_TOKEN = "<YOUR_SWAGGER_FUNCTIONAL_TESTING_API_TOKEN>" ZEPHYR_API_TOKEN = "<YOUR_ZEPHYR_API_TOKEN>"
Install SmartBear MCP in Gemini CLI
$ gemini mcp add -s user -e 'BEARQ_API_TOKEN=<YOUR_BEARQ_API_TOKEN>' -e 'BUGSNAG_AUTH_TOKEN=<YOUR_BUGSNAG_AUTH_TOKEN>' -e 'PACT_BROKER_PASSWORD=<YOUR_PACT_BROKER_PASSWORD>' -e 'PACT_BROKER_TOKEN=<YOUR_PACT_BROKER_TOKEN>' -e 'QTM4J_API_KEY=<YOUR_QTM4J_API_KEY>' -e 'QTM4J_AUTOMATION_API_KEY=<YOUR_QTM4J_AUTOMATION_API_KEY>' -e 'REFLECT_API_TOKEN=<YOUR_REFLECT_API_TOKEN>' -e 'SWAGGER_API_KEY=<YOUR_SWAGGER_API_KEY>' -e 'SWAGGER_FUNCTIONAL_TESTING_API_TOKEN=<YOUR_SWAGGER_FUNCTIONAL_TESTING_API_TOKEN>' -e 'ZEPHYR_API_TOKEN=<YOUR_ZEPHYR_API_TOKEN>' smartbear-mcp npx -- -y @smartbear/mcpInstall SmartBear MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"smartbear-mcp": {
"command": "npx",
"args": [
"-y",
"@smartbear/mcp"
],
"env": {
"BEARQ_API_TOKEN": "<YOUR_BEARQ_API_TOKEN>",
"BUGSNAG_AUTH_TOKEN": "<YOUR_BUGSNAG_AUTH_TOKEN>",
"PACT_BROKER_PASSWORD": "<YOUR_PACT_BROKER_PASSWORD>",
"PACT_BROKER_TOKEN": "<YOUR_PACT_BROKER_TOKEN>",
"QTM4J_API_KEY": "<YOUR_QTM4J_API_KEY>",
"QTM4J_AUTOMATION_API_KEY": "<YOUR_QTM4J_AUTOMATION_API_KEY>",
"REFLECT_API_TOKEN": "<YOUR_REFLECT_API_TOKEN>",
"SWAGGER_API_KEY": "<YOUR_SWAGGER_API_KEY>",
"SWAGGER_FUNCTIONAL_TESTING_API_TOKEN": "<YOUR_SWAGGER_FUNCTIONAL_TESTING_API_TOKEN>",
"ZEPHYR_API_TOKEN": "<YOUR_ZEPHYR_API_TOKEN>"
}
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for @smartbear/mcp 0.44.0 in an isolated container with no network and no keys. It answered and listed 1 tool.
SmartBear MCP tools 1
Read from the server with tools/listsmartbear_list_integrationsRead-onlyLists every SmartBear product this server supports, whether it is configured for this connection, and for unconfigured products the environment variable or HTTP header each setting needs. Only products allowed by the server's MCP_CLIENTS setting are listed. Products that accept per-request OAuth tokens (BearQ, Reflect, QMetry) always show as configured. Takes no parameters.
| smartbear_list_integrations | Lists every SmartBear product this server supports, whether it is configured for this connection, and for unconfigured products the environment variable or HTTP header each setting needs. Only products allowed by the server's MCP_CLIENTS setting are listed. Products that accept per-request OAuth tokens (BearQ, Reflect, QMetry) always show as configured. Takes no parameters. | Read-only |
Configuration
BEARQ_API_TOKENSecretBearQ workspace API token. Leave empty to disable BearQ tools. Learn more: https://developer.smartbear.com/smartbear-mcp/docs/bearq-integration
BUGSNAG_AUTH_TOKENSecretBugSnag auth token. Leave empty to disable BugSnag tools. Learn more: https://developer.smartbear.com/smartbear-mcp/docs/bugsnag-integration
PACT_BROKER_PASSWORDSecretPact Broker password (alternative to token). Learn more: https://developer.smartbear.com/smartbear-mcp/docs/contract-testing-with-pactflow
PACT_BROKER_TOKENSecretPactFlow authentication token. Learn more: https://developer.smartbear.com/smartbear-mcp/docs/contract-testing-with-pactflow
QTM4J_API_KEYSecretQTM4J (QMetry Test Management for Jira) API key. Leave empty to disable QTM4J tools. Learn more: https://developer.smartbear.com/smartbear-mcp/docs/qtm4j-integration
QTM4J_AUTOMATION_API_KEYSecretQTM4J Automation API key used exclusively by the automation import tools. Leave empty to disable automation tools. Learn more: https://developer.smartbear.com/smartbear-mcp/docs/qtm4j-integration
REFLECT_API_TOKENSecretReflect API token. Leave empty to disable Reflect tools. Learn more: https://developer.smartbear.com/smartbear-mcp/docs/reflect-integration
SWAGGER_API_KEYSecretSwagger API key. Leave empty to disable Swagger tools. Learn more: https://developer.smartbear.com/smartbear-mcp/docs/swagger-portal-integration
SWAGGER_FUNCTIONAL_TESTING_API_TOKENSecretSwagger Functional Testing API token. Leave empty to disable Functional Testing tools. Learn more: https://developer.smartbear.com/smartbear-mcp/docs/functional-testing-integration
ZEPHYR_API_TOKENSecretThe Zephyr Cloud API token for authentication. Learn more: https://support.smartbear.com/zephyr/docs/en/rest-api/api-access-tokens-management.html
BEARQ_API_BASE_URLOverride the BearQ public API base URL (optional). Defaults to https://api.bearq.smartbear.com
BUGSNAG_PROJECT_API_KEYBugSnag project API key (optional; narrows interactions to a single project). Learn more: https://developer.smartbear.com/smartbear-mcp/docs/bugsnag-integration
COLLABORATOR_BASE_URLCOLLABORATOR_LOGIN_TICKETCOLLABORATOR_USERNAMEMCP_CLIENTSPACT_BROKER_BASE_URLPactFlow/Pact Broker base URL. Leave empty to disable Pact tools. Learn more: https://developer.smartbear.com/smartbear-mcp/docs/contract-testing-with-pactflow
PACT_BROKER_USERNAMEPact Broker username (alternative to token). Learn more: https://developer.smartbear.com/smartbear-mcp/docs/contract-testing-with-pactflow
QMETRY_API_KEYQMETRY_BASE_URLQTM4J_BASE_URLQTM4J base URL (optional). Defaults to https://qtmcloud.qmetry.com. Override when using a self-hosted or region-specific instance.
SWAGGER_FUNCTIONAL_TESTING_BASE_PATHOverride the Swagger Functional Testing API base URL (optional). Defaults to https://api.reflect.run/v1
SWAGGER_PORTAL_BASE_PATHSWAGGER_REGISTRY_BASE_PATHSWAGGER_UI_BASE_PATHZEPHYR_BASE_URLThe Zephyr Cloud API base url. Should be changed depending on the region of your Jira instance. Learn more: https://support.smartbear.com/zephyr-scale-cloud/api-docs/#section/Authentication/Accessing-the-API
| Name | Description | |
|---|---|---|
| BEARQ_API_TOKEN | BearQ workspace API token. Leave empty to disable BearQ tools. Learn more: https://developer.smartbear.com/smartbear-mcp/docs/bearq-integration | Secret |
| BUGSNAG_AUTH_TOKEN | BugSnag auth token. Leave empty to disable BugSnag tools. Learn more: https://developer.smartbear.com/smartbear-mcp/docs/bugsnag-integration | Secret |
| PACT_BROKER_PASSWORD | Pact Broker password (alternative to token). Learn more: https://developer.smartbear.com/smartbear-mcp/docs/contract-testing-with-pactflow | Secret |
| PACT_BROKER_TOKEN | PactFlow authentication token. Learn more: https://developer.smartbear.com/smartbear-mcp/docs/contract-testing-with-pactflow | Secret |
| QTM4J_API_KEY | QTM4J (QMetry Test Management for Jira) API key. Leave empty to disable QTM4J tools. Learn more: https://developer.smartbear.com/smartbear-mcp/docs/qtm4j-integration | Secret |
| QTM4J_AUTOMATION_API_KEY | QTM4J Automation API key used exclusively by the automation import tools. Leave empty to disable automation tools. Learn more: https://developer.smartbear.com/smartbear-mcp/docs/qtm4j-integration | Secret |
| REFLECT_API_TOKEN | Reflect API token. Leave empty to disable Reflect tools. Learn more: https://developer.smartbear.com/smartbear-mcp/docs/reflect-integration | Secret |
| SWAGGER_API_KEY | Swagger API key. Leave empty to disable Swagger tools. Learn more: https://developer.smartbear.com/smartbear-mcp/docs/swagger-portal-integration | Secret |
| SWAGGER_FUNCTIONAL_TESTING_API_TOKEN | Swagger Functional Testing API token. Leave empty to disable Functional Testing tools. Learn more: https://developer.smartbear.com/smartbear-mcp/docs/functional-testing-integration | Secret |
| ZEPHYR_API_TOKEN | The Zephyr Cloud API token for authentication. Learn more: https://support.smartbear.com/zephyr/docs/en/rest-api/api-access-tokens-management.html | Secret |
| BEARQ_API_BASE_URL | Override the BearQ public API base URL (optional). Defaults to https://api.bearq.smartbear.com | |
| BUGSNAG_PROJECT_API_KEY | BugSnag project API key (optional; narrows interactions to a single project). Learn more: https://developer.smartbear.com/smartbear-mcp/docs/bugsnag-integration | |
| COLLABORATOR_BASE_URL | — | |
| COLLABORATOR_LOGIN_TICKET | — | |
| COLLABORATOR_USERNAME | — | |
| MCP_CLIENTS | — | |
| PACT_BROKER_BASE_URL | PactFlow/Pact Broker base URL. Leave empty to disable Pact tools. Learn more: https://developer.smartbear.com/smartbear-mcp/docs/contract-testing-with-pactflow | |
| PACT_BROKER_USERNAME | Pact Broker username (alternative to token). Learn more: https://developer.smartbear.com/smartbear-mcp/docs/contract-testing-with-pactflow | |
| QMETRY_API_KEY | — | |
| QMETRY_BASE_URL | — | |
| QTM4J_BASE_URL | QTM4J base URL (optional). Defaults to https://qtmcloud.qmetry.com. Override when using a self-hosted or region-specific instance. | |
| SWAGGER_FUNCTIONAL_TESTING_BASE_PATH | Override the Swagger Functional Testing API base URL (optional). Defaults to https://api.reflect.run/v1 | |
| SWAGGER_PORTAL_BASE_PATH | — | |
| SWAGGER_REGISTRY_BASE_PATH | — | |
| SWAGGER_UI_BASE_PATH | — | |
| ZEPHYR_BASE_URL | The Zephyr Cloud API base url. Should be changed depending on the region of your Jira instance. Learn more: https://support.smartbear.com/zephyr-scale-cloud/api-docs/#section/Authentication/Accessing-the-API |
Automated checks
Ran Nov 16, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablesmartbear/smartbear-mcp is public and reachablegithub.com/smartbear/smartbear-mcp ↗Pass
- Package names this repository as its source@smartbear/mcp names smartbear/smartbear-mcp as sourcenpmjs.com/package/@smartbear/mcp ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for @smartbear/mcpnpmjs.com/package/@smartbear/mcp/v/0.44.0#provenance ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-16github.com/smartbear/smartbear-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @smartbear/mcpPass
- No critical advisory in the package or its dependenciesthe package checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model1 tool description and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubA 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.
| Product | Server URL |
|---|---|
| Swagger | https://swagger.mcp.smartbear.com/mcp |
| BugSnag | https://bugsnag.mcp.smartbear.com/mcp |
| Zephyr | https://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.
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:
{
"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:
{
"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)
| Variable | Default | Purpose |
|---|---|---|
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_PROXY |
false |
Set 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
- Search open and closed issues for similar problems
- Report a bug or request a feature
SmartBear MCP Server - Bringing the power of SmartBear's testing and monitoring ecosystem to your AI-powered development workflow.
SmartBear MCP questions
How do I add SmartBear MCP to Claude Code?
Run claude mcp add --env 'BEARQ_API_TOKEN=<YOUR_BEARQ_API_TOKEN>' --env 'BUGSNAG_AUTH_TOKEN=<YOUR_BUGSNAG_AUTH_TOKEN>' --env 'PACT_BROKER_PASSWORD=<YOUR_PACT_BROKER_PASSWORD>' --env 'PACT_BROKER_TOKEN=<YOUR_PACT_BROKER_TOKEN>' --env 'QTM4J_API_KEY=<YOUR_QTM4J_API_KEY>' --env 'QTM4J_AUTOMATION_API_KEY=<YOUR_QTM4J_AUTOMATION_API_KEY>' --env 'REFLECT_API_TOKEN=<YOUR_REFLECT_API_TOKEN>' --env 'SWAGGER_API_KEY=<YOUR_SWAGGER_API_KEY>' --env 'SWAGGER_FUNCTIONAL_TESTING_API_TOKEN=<YOUR_SWAGGER_FUNCTIONAL_TESTING_API_TOKEN>' --env 'ZEPHYR_API_TOKEN=<YOUR_ZEPHYR_API_TOKEN>' smartbear-mcp -- npx -y @smartbear/mcp in your terminal. Add --scope user to make it available in every project.
How do I add SmartBear MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does SmartBear MCP provide?
It exposes 1 tool, including smartbear_list_integrations.
What SmartBear products does this MCP server support?
It supports BearQ, BugSnag, Reflect, Swagger, PactFlow, Pact Broker, QMetry, QTM4J, Zephyr and Collaborator.
Do I need to install anything to use the remote MCP servers?
No. For BugSnag, Swagger, and Zephyr, SmartBear hosts remote servers you connect to by URL with no installation, Node.js, or API tokens required.
How does authentication work for the remote MCP servers?
Authentication is handled through an OAuth browser flow.
What are the prerequisites for running the local npm MCP server?
You need Node.js 22+ and npm, access to SmartBear products, and valid API tokens for the products you want to integrate.
Where do I configure the MCP server for VS Code with Copilot?
Add the server configuration to your .vscode/mcp.json file, using npx to run the @smartbear/mcp package.