home / mcp / wordware mcp server

Wordware MCP Server

Provides dynamic access to Wordware tools through MCP clients with automatic schema detection and robust error handling.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "aleksandrkrivolap-wordware-mcp": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "env": {
        "WORDWARE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You can run a Wordware MCP server that bridges Claude and other MCP-compatible assistants to Wordware’s specialized agent capabilities. It dynamically loads tools from Wordware, adapts to tool input schemas, and handles diverse parameter formats, giving you a flexible, robust way to extend AI assistants with Wordware flows.

How to use

Install and run the Wordware MCP server to expose Wordware tools to MCP clients such as Claude Desktop. The server loads tools listed in a configuration file, detects each tool’s input requirements, and registers them as MCP tools. When a tool is called, it formats inputs correctly, sends requests to the Wordware API, and returns structured results suitable for Claude.

How to install

Prerequisites you must have before installing the server.

Python 3.8+
Wordware API credentials
Claude Desktop or another MCP-compatible client

Clone the project, set up a Python virtual environment, install dependencies, and prepare credentials.

# Clone the repository
git clone https://github.com/yourusername/wordware-mcp.git
cd wordware-mcp

# Create a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Set up environment variables
cp .env.example .env
# Edit .env with your Wordware API credentials

Configuration and running the server

Create a tools_config.json file with IDs of the Wordware tools you want to load. The server will fetch tool metadata from the Wordware API and register them as MCP tools.

{
  "tools": [
    {
      "id": "your-tool-id-1"
    },
    {
      "id": "your-tool-id-2"
    },
    {
      "id": "your-tool-id-3"
    }
  ]
}

Running the server

Start the server with the default settings, enable debug logging if needed, or run with a custom transport. You can also install the server for use directly from Claude Desktop.

# Run with default settings
python server.py

# Run with debug logging
python server.py --debug

# Run with SSE transport on a specific port
python server.py --transport sse --host 127.0.0.1 --port 8000

# Or install in Claude Desktop
mcp install python server.py --name "Wordware Tools"

Advanced usage and configuration notes

The server automatically loads tools based on your configuration, detects input schemas, and adapts parameter formats before sending requests to Wordware. It handles various input formats such as direct JSON, JSON strings inside kwargs, and nested parameter structures. If you need to override the configuration path, set the CONFIG_PATH environment variable.

Troubleshooting

If a tool does not appear in the client, ensure the server is running and has registered the tool. Authentication issues usually point to Wordware API credentials in your .env file. Validate input formats against the tool’s requirements, and restart the server if you encounter event loop errors.

Development

For debugging, run the server with verbose logging and check the logs for detailed information. Use the provided logging outputs to identify misconfigured tools or schema mismatches.

# Run with debug logging
python server.py --debug

# Check the logs for detailed information
tail -f /path/to/your/logs/mcp.log