wordware-mcp

@yuhuangou

About wordware-mcp

Local MCP server for running Wordware apps

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "wordware-mcp": {
      "command": "npx",
      "args": [
        "wordware-mcp"
      ]
    }
  }
}

Tools

No tools detected

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

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.

Frequently asked questions

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`: ```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.