# Wiro AI MCP server

Run image, video, audio and LLM models on Wiro AI straight from your AI assistant.

## At a glance

Wiro AI is an MCP server in the Design & Media category. It runs locally over stdio via `npx -y @wiro-ai/wiro-mcp`, and needs WIRO_API_KEY, Authorization and WIRO_API_SECRET. It exposes 13 tools, including search_models, get_model_schema and recommend_model. It scores A (85/100) on the MCP Skills Hub health score as of Oct 28, 2026.

## Install

### How to install Wiro AI in Claude Code

1. Add the server

```bash
claude mcp add wiro -e 'WIRO_API_KEY=<WIRO_API_KEY>' -e 'WIRO_API_SECRET=<WIRO_API_SECRET>' -- npx -y @wiro-ai/wiro-mcp
```

2. Fill in your credentials

   Replace <WIRO_API_KEY>, <WIRO_API_SECRET>, Bearer <YOUR_TOKEN> with your real values. Keep secrets out of any config file you commit.

3. Verify it's connected

```bash
claude mcp list
```

4. Sharing it with your team?

   Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).

5. Use it in a session

   Ask Claude to use the tools this server exposes (e.g. search_models, get_model_schema, recommend_model). It discovers them automatically.

### How to install Wiro AI in Claude Desktop

1. Open your MCP config

   macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add this server

```json
{
  "mcpServers": {
    "wiro": {
      "command": "npx",
      "args": [
        "-y",
        "@wiro-ai/wiro-mcp"
      ],
      "env": {
        "WIRO_API_KEY": "<WIRO_API_KEY>",
        "WIRO_API_SECRET": "<WIRO_API_SECRET>"
      }
    }
  }
}
```

3. Fill in your credentials

   Replace <WIRO_API_KEY>, <WIRO_API_SECRET>, Bearer <YOUR_TOKEN> with your real values. Keep secrets out of any config file you commit.

4. Restart Claude Desktop

   The tools appear under the 🔌 menu once the app reloads.

### How to install Wiro AI in Cursor

1. Create / edit .cursor/mcp.json in your project

```json
{
  "mcpServers": {
    "wiro": {
      "command": "npx",
      "args": [
        "-y",
        "@wiro-ai/wiro-mcp"
      ],
      "env": {
        "WIRO_API_KEY": "<WIRO_API_KEY>",
        "WIRO_API_SECRET": "<WIRO_API_SECRET>"
      }
    }
  }
}
```

2. Fill in your credentials

   Replace <WIRO_API_KEY>, <WIRO_API_SECRET>, Bearer <YOUR_TOKEN> with your real values. Keep secrets out of any config file you commit.

3. Enable it

   Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.

### How to install Wiro AI in Codex CLI

1. Add to ~/.codex/config.toml

```toml
[mcp_servers.wiro]
command = "npx"
args = ["-y", "@wiro-ai/wiro-mcp"]
env = { WIRO_API_KEY = "<WIRO_API_KEY>", WIRO_API_SECRET = "<WIRO_API_SECRET>" }
```

2. Fill in your credentials

   Replace <WIRO_API_KEY>, <WIRO_API_SECRET>, Bearer <YOUR_TOKEN> with your real values. Keep secrets out of any config file you commit.

3. Run Codex

   Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.

### How to install Wiro AI in Windsurf

1. Edit ~/.codeium/windsurf/mcp_config.json

```json
{
  "mcpServers": {
    "wiro": {
      "command": "npx",
      "args": [
        "-y",
        "@wiro-ai/wiro-mcp"
      ],
      "env": {
        "WIRO_API_KEY": "<WIRO_API_KEY>",
        "WIRO_API_SECRET": "<WIRO_API_SECRET>"
      }
    }
  }
}
```

2. Fill in your credentials

   Replace <WIRO_API_KEY>, <WIRO_API_SECRET>, Bearer <YOUR_TOKEN> with your real values. Keep secrets out of any config file you commit.

3. Reload

   Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.

### How to install Wiro AI in Cline

1. Open Cline → MCP Servers → Configure

   Adds to cline_mcp_settings.json.

2. Add the server

```json
{
  "mcpServers": {
    "wiro": {
      "command": "npx",
      "args": [
        "-y",
        "@wiro-ai/wiro-mcp"
      ],
      "env": {
        "WIRO_API_KEY": "<WIRO_API_KEY>",
        "WIRO_API_SECRET": "<WIRO_API_SECRET>"
      }
    }
  }
}
```

3. Fill in your credentials

   Replace <WIRO_API_KEY>, <WIRO_API_SECRET>, Bearer <YOUR_TOKEN> with your real values. Keep secrets out of any config file you commit.

### How to install Wiro AI in VS Code

1. Create .vscode/mcp.json

```json
{
  "servers": {
    "wiro": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@wiro-ai/wiro-mcp"
      ],
      "env": {
        "WIRO_API_KEY": "<WIRO_API_KEY>",
        "WIRO_API_SECRET": "<WIRO_API_SECRET>"
      }
    }
  }
}
```

2. Fill in your credentials

   Replace <WIRO_API_KEY>, <WIRO_API_SECRET>, Bearer <YOUR_TOKEN> with your real values. Keep secrets out of any config file you commit.

3. Start it

   VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.

## Tools

- `search_models` — Search and browse AI models by keyword, category, or owner
- `get_model_schema` — Get full parameter schema and pricing for any model
- `recommend_model` — Describe what you want to build, get model recommendations by relevance
- `explore` — Browse curated models organized by category — no parameters needed
- `run_model` — Run any model — waits up to 45s by default, then returns a recoverable task token
- `wait_for_task` — Continue waiting for an existing task without submitting or billing a duplicate run
- `get_task` — Check task status immediately or wait up to 45s with `wait_seconds`
- `list_tasks` — Browse authenticated task history across conversations, then continue with `get_task`
- `get_task_price` — Get the cost of a completed task
- `cancel_task` — Cancel a queued task
- `kill_task` — Kill a running task
- `upload_file` — Upload a file from URL for use as model input
- `search_docs` — Search the Wiro documentation for guides and API references

Source repository: https://github.com/wiroai/Wiro-MCP

---

Source: https://mcp-skills-hub.vercel.app/mcps/ai-wiro-mcp · MCP Skills Hub · data as of 2026-10-28T12:31:05Z