wordware-mcp

What is wordware-mcp?

The Wordware MCP server allows you to run your Wordware apps locally, integrating Wordware’s AI flows directly into your local development environment for easier testing and development.

How to use wordware-mcp?

Run npx wordware-mcp for an interactive setup that prompts for your API key and optional Claude configuration. After configuration, start the server with npx wordware-mcp start. You can also install globally (npm install -g wordware-mcp) or pass arguments directly via command line (e.g., wordware-mcp --api-key your-api-key --port 3000).

Key features of wordware-mcp

• Interactive installation with npx wordware-mcp
• Automatic discovery of Wordware app tools (no APP_IDs needed)
• Local API endpoint at http://localhost:9000/{WORDWARE_API_TOKEN}
• Command-line argument support for API key and port
• Automatic Claude Desktop configuration setup
• Hot reloading during development

Use cases of wordware-mcp

• Develop and test Wordware AI flows locally before deploying
• Integrate Wordware apps into local scripts or applications via HTTP requests
• Run Wordware flows from AI assistants like Claude Desktop
• Iterate on Wordware app logic with immediate feedback during development

FAQ from wordware-mcp

What are the prerequisites for using wordware-mcp?

You need a Wordware account, a Wordware API key, and at least one deployed Wordware app.

How do I configure the server?

Configuration can be done via a .env file (containing WORDWARE_API_KEY and PORT) or by passing --api-key and --port command‑line arguments.

How do I use this with Claude Desktop?

Add the following JSON to ~/Library/Application\ Support/Claude/claude_desktop_config.json:

{ "mcpServers": { "wordware": { "command": "wordware-mcp" } } }

Then run npx wordware-mcp interactive setup or start the server.

What if I see a “command not found” error after installation?

Install the package globally: npm install -g wordware-mcp. Ensure your npm global path is in your PATH variable.

What transport does the server use and where does data live?

The server runs a local HTTP server on port 3000 by default. Data flows through your local machine to the Wordware API via your API key. No persistent database is mentioned.