SmartBear MCP server

An MCP server for SmartBear's API Hub, Test Hub and Insight Hub.

Usage

The server is started with the API key or auth token that you use with your product(s). They are optional and can be removed from your configuration if you aren't using the product.

VS Code

Add the @smartbear/mcp package to your project via NPM or via the "MCP: Add server…" command in VS Code.

If setting up manually, add the following configuration to .vscode/mcp.json:

{
  "servers": {
    "smartbear": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@smartbear/mcp@latest"
      ],
      "env": {
        "INSIGHT_HUB_AUTH_TOKEN": "${input:insight_hub_auth_token}",
        "REFLECT_API_TOKEN": "${input:reflect_api_token}",
        "API_HUB_API_KEY": "${input:api_hub_api_key}"
      }
    }
  },
  "inputs": [
      {
         "id": "insight_hub_auth_token",
         "type": "promptString",
         "description": "Insight Hub Auth Token",
         "password": true
      },
      {
         "id": "reflect_api_token",
         "type": "promptString",
         "description": "Reflect API Token",
         "password": true
      },
      {
         "id": "api_hub_api_key",
         "type": "promptString",
         "description": "API Hub API Key",
         "password": true
      }
  ]
}

MCP Inspector

To test the MCP server using the npm package, run:

REFLECT_API_TOKEN=your_reflect_token INSIGHT_HUB_AUTH_TOKEN=your_insight_hub_token API_HUB_API_KEY=your_api_hub_api_key npx @smartbear/mcp

This will open an inspector window in your browser, where you can test the tools.

Environment Variables

• INSIGHT_HUB_AUTH_TOKEN: Required for Insight Hub tools. The Auth Token for Insight Hub.
• REFLECT_API_TOKEN: Required for Reflect tools. The Reflect Account API Key for Reflect-based tools.
• API_HUB_API_KEY: Required for API Hub tools. The API Key for API Hub tools.
• MCP_SERVER_INSIGHT_HUB_API_KEY: Optional. If set, enables error reporting of the MCP_server code via the BugSnag SDK. This is useful for debugging and monitoring of the MCP server itself and shouldn't be set to the same API key as your app.

Supported Tools

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

• Insight Hub
  Get your top events and invite your LLM to help you fix them.
• Reflect
• API Hub

Local Development

If you want to build and run the MCP server from source (for development or contribution):

Build

Clone this repository and run:

npm install
npm run build

Usage (Local Build)

Update your .vscode/mcp.json to point to your local build:

{
  "servers": {
    "smartbear": {
      "type": "stdio",
      "command": "node",
      "args": ["<PATH_TO_SMARTBEAR_MCP>/dist/index.js"],
      "env": {
        "INSIGHT_HUB_AUTH_TOKEN": "${input:insight_hub_auth_token}",
        "REFLECT_API_TOKEN": "${input:reflect_api_token}",
        "API_HUB_API_KEY": "${input:api_hub_api_key}"
      }
    }
  },
  "inputs": [
    // ...same as above...
  ]
}

Or run the server directly:

REFLECT_API_TOKEN=your_reflect_token INSIGHT_HUB_AUTH_TOKEN=your_insight_hub_token API_HUB_API_KEY=your_api_hub_api_key node dist/index.js

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.