home / mcp / wordware mcp server

Wordware MCP Server

Local MCP server for running Wordware apps

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "hugobiais-wordware-mcp": {
      "command": "npx",
      "args": [
        "wordware-mcp",
        "start"
      ],
      "env": {
        "PORT": "3000",
        "WORDWARE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

The Wordware MCP Server lets you run Wordware AI flows locally, so you can test, develop, and integrate AI-powered Wordware apps in your own environment with ease. It exposes an HTTP endpoint and a local runtime that your apps can call, enabling rapid iteration and local testing before deploying to production.

How to use

You can run the Wordware MCP Server directly with an inline command using a local MCP client or run it as a globally installed tool. Start by configuring your API key and port, then start the server. Once running, you can trigger your Wordware apps via HTTP requests to the local endpoint or use the included CLI to manage the server lifecycle.

Two practical ways to use it: - Start the MCP server with an inline command using your terminal or integrate it into your development workflow. - Call your Wordware apps locally via the provided HTTP endpoint to test prompts and flows as you build them.

How to install

# Interactive setup (recommended)
npx wordware-mcp

# If you prefer a permanent install, you can install globally or locally
# Global install
npm install -g wordware-mcp

# Local install in your project
npm install wordware-mcp

# Start the MCP server after configuration
npx wordware-mcp start

Configuration and usage notes

Prerequisites you need before using the MCP server are a Wordware account, a Wordware API key, and at least one deployed Wordware app.

Configuration can be done via environment variables or command line arguments. The key values you’ll commonly set are the API key and the port you want the server to run on.

Example ways to configure:
- In an .env file: WORDWARE_API_KEY=your-api-key, PORT=3000
- Directly on the command line: --api-key your-api-key --port 3000
- Via an inline interactive setup with npx wordware-mcp, which will guide you through entering the API key and optional Claude configuration.

Additional notes

After successful setup, your Wordware apps are reachable locally. A typical development flow involves starting the MCP server and then sending requests to the local endpoint to run specific apps.

If you are integrating with Claude Desktop, you can configure Claude by editing the Claude desktop config to point at the MCP server using a simple command entry for the Wordware MCP server.

Troubleshooting

If you encounter issues starting or calling the MCP server, verify that the server is running on the expected port and that your API key is correctly set. Check for common issues like missing environment variables or incorrect start commands, and retry with verbose logging if available.

Available tools

startMCP

Start the MCP server from the CLI to run Wordware apps locally.

interactiveSetup

Run the interactive setup to configure API key and Claude integration via npx wordware-mcp.

callWordwareApp

Trigger a Wordware app by sending HTTP requests to the local API endpoint.