WxMCPServer

v1.0.0Cloud Servicesstable

**WxMCPServer** is an IBM webMethods Hybrid Integration (IWHI) based MCP server, that enables existing APIs to be used as MCP tools.

wxmcpservermcpai-integration
Share:
20
Stars
0
Downloads
0
Weekly
0/5

What is WxMCPServer?

WxMCPServer is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to **wxmcpserver** is an ibm webmethods hybrid integration (iwhi) based mcp server, that enables existing apis to be used as mcp tools.

**WxMCPServer** is an IBM webMethods Hybrid Integration (IWHI) based MCP server, that enables existing APIs to be used as MCP tools.

This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • **WxMCPServer** is an IBM webMethods Hybrid Integration (IWH

Use Cases

Expose existing APIs as MCP tools
API integration for AI agents
IBM

Maintainer

LicenseApache-2.0
Languagejava
Versionv1.0.0
UpdatedMay 6, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx wxmcpserver

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use WxMCPServer

WxMCPServer is an IBM webMethods Hybrid Integration (IWHI) based MCP server that bridges enterprise APIs managed by IBM API Gateway with AI assistants via the Model Context Protocol. It introspects an API management catalog and dynamically exposes discovered APIs as MCP tools without requiring code changes to the underlying services. Teams use it to let AI agents call production enterprise APIs — with existing security policies (authentication, logging, authorization) enforced — directly from Claude or other MCP-compatible clients.

Prerequisites

  • IBM webMethods Integration Server (local) or IBM webMethods Hybrid Integration (SaaS) environment
  • Access to an IBM API Gateway with a populated tool catalog
  • An MCP-compatible client such as Claude Desktop
  • mcp-remote npm package (npx -y mcp-remote) for stdio-to-HTTP bridging
  • API credentials (API key or OAuth token) for your API Gateway
1

Deploy or configure the WxMCPServer package

For a local webMethods Integration Server, load the WxMCPServer package from the webMethods Package Registry using Service Designer. For IBM webMethods Hybrid Integration (SaaS), add the GitHub repository as an external package to your project and sync it.

2

Configure the global variables on the Integration Server

Set the required global configuration variables on your Integration Server. At minimum, set wxmcp.auth.type (e.g., API_KEY) and wxmcp.tool.catalog.base.url to point to your API Gateway's tool catalog endpoint.

wxmcp.auth.type=API_KEY
wxmcp.tool.catalog.base.url=https://<gateway-host>:<port>/gateway/WxMCP-Tool-Catalog/1.1
wxmcp.api.key.headername=x-Gateway-APIKey
wxmcp.tool.response.mode=structured
wxmcp.response.code=http
3

Verify the MCP endpoint is reachable

After deploying, the MCP HTTP endpoint is available at http://<Integration-Server-Host>:<Port>/mcp. Test it with a simple HTTP request to confirm the server is running and returning a valid MCP response.

curl http://localhost:5555/mcp
4

Configure Claude Desktop to connect via mcp-remote

Because the server runs as an HTTP MCP endpoint (not stdio), use the mcp-remote bridge package in your Claude Desktop config. Pass authentication credentials as HTTP headers.

{
  "mcpServers": {
    "wxmcpserver": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://<integration-server-host>:<port>/mcp",
        "--header", "x-auth-type:API_KEY",
        "--header", "x-api-key:<your-api-key>",
        "--header", "x-tool-catalog-base-url:https://<gateway-host>:<port>/gateway/WxMCP-Tool-Catalog/1.1",
        "--header", "x-api-key-headername:x-Gateway-APIKey",
        "--header", "x-tool-response-mode:structured",
        "--header", "x-response-code:http"
      ]
    }
  }
}
5

Test tool discovery and invocation

Restart Claude Desktop and ask Claude to list available tools. The server dynamically loads tool definitions from the API catalog. Invoke a tool by name and confirm that the response passes through the API Gateway's security policies correctly.

WxMCPServer Examples

Client configuration

Claude Desktop configuration using mcp-remote to connect to a WxMCPServer HTTP endpoint with API key authentication.

{
  "mcpServers": {
    "wxmcpserver": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://my-integration-server:5555/mcp",
        "--header", "x-auth-type:API_KEY",
        "--header", "x-api-key:my-gateway-api-key",
        "--header", "x-tool-catalog-base-url:https://my-gateway:9072/gateway/WxMCP-Tool-Catalog/1.1",
        "--header", "x-api-key-headername:x-Gateway-APIKey",
        "--header", "x-tool-response-mode:structured",
        "--header", "x-response-code:http"
      ]
    }
  }
}

Prompts to try

Example prompts once WxMCPServer is connected and has discovered tools from your API catalog.

- "What tools are available through the enterprise API gateway?"
- "Call the customer lookup API with customer ID 12345"
- "Submit an order using the order management API with the following details: ..."
- "Retrieve the current inventory levels for product SKU ABC-001"

Troubleshooting WxMCPServer

No tools appear after connecting to the MCP endpoint

Check that wxmcp.tool.catalog.base.url is set correctly and the API Gateway catalog endpoint is reachable from the Integration Server. Tools load on-demand from the catalog; if the catalog URL is wrong or the API key lacks read permissions, the tool list will be empty.

Authentication errors when invoking tools

Ensure the auth headers passed via mcp-remote match the wxmcp.auth.type configured on the server. For API_KEY mode, both x-api-key and x-api-key-headername must be correct. Headers can also be overridden at the server level via global variable configuration.

API calls succeed but responses are malformed

Only application/json Content-Type is supported for API communication. Ensure your backend APIs return JSON. Set x-tool-response-mode to 'structured' for well-formed JSON responses, or 'text' if you need raw string output.

Frequently Asked Questions about WxMCPServer

What is WxMCPServer?

WxMCPServer is a Model Context Protocol (MCP) server that **wxmcpserver** is an ibm webmethods hybrid integration (iwhi) based mcp server, that enables existing apis to be used as mcp tools. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install WxMCPServer?

Follow the installation instructions on the WxMCPServer GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with WxMCPServer?

WxMCPServer works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is WxMCPServer free to use?

Yes, WxMCPServer is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.

Browse More Cloud Services MCP Servers

Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "wxmcpserver": { "command": "npx", "args": ["-y", "wxmcpserver"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use WxMCPServer?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides