Wiro MCP

Wiro MCP Server

Official MCP server for Wiro AI — access all AI models on Wiro from Cursor, Claude, Windsurf, and any MCP-compatible AI assistant.

[](https://www.npmjs.com/package/@wiro-ai/wiro-mcp) [](https://modelcontextprotocol.io/) [](./LICENSE)

Official MCP Server · Self-Hosted MCP · Models · Dashboard · Docs

Quick Start

1. Get API Keys

Sign up at wiro.ai and create a project at wiro.ai/panel/project/new to get your API key and secret.

2. Add to Your AI Assistant

Cursor — open MCP settings (Cmd+Shift+P → "Open MCP settings") and add:

{
  "mcpServers": {
    "wiro": {
      "command": "npx",
      "args": ["-y", "@wiro-ai/wiro-mcp"],
      "env": {
        "WIRO_API_KEY": "your-api-key",
        "WIRO_API_SECRET": "your-api-secret"
      }
    }
  }
}

Claude Code:

claude mcp add wiro -- npx -y @wiro-ai/wiro-mcp

Then set environment variables WIRO_API_KEY and WIRO_API_SECRET.

Claude Desktop — add to claude_desktop_config.json:

{
  "mcpServers": {
    "wiro": {
      "command": "npx",
      "args": ["-y", "@wiro-ai/wiro-mcp"],
      "env": {
        "WIRO_API_KEY": "your-api-key",
        "WIRO_API_SECRET": "your-api-secret"
      }
    }
  }
}

Windsurf — add to MCP settings:

{
  "mcpServers": {
    "wiro": {
      "command": "npx",
      "args": ["-y", "@wiro-ai/wiro-mcp"],
      "env": {
        "WIRO_API_KEY": "your-api-key",
        "WIRO_API_SECRET": "your-api-secret"
      }
    }
  }
}

3. Start Using

Ask your AI assistant:

• "Generate a photorealistic image of a mountain lake at sunset"
• "What video generation models are available on Wiro?"
• "Show me the parameters for openai/sora-2"
• "Create a 5-second video with Kling V3 — a drone shot over mountains"
• "Check the status of my last task"

Authentication

Wiro supports two authentication types (chosen when creating a project):

Signature-Based (Recommended)

More secure. Requires both API key and API secret.

WIRO_API_KEY=your-api-key
WIRO_API_SECRET=your-api-secret

API Key Only

Simpler. Only requires the API key. Omit WIRO_API_SECRET from your config.

WIRO_API_KEY=your-api-key

Available Tools

| Tool | Description | |------|-------------| | 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 — wait for result or get task token | | get_task | Check task status, outputs, and cost | | 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 |

Hosted MCP Server

Wiro also provides a hosted MCP server at https://mcp.wiro.ai/v1 that requires no local installation. See the MCP Server documentation for setup instructions.

Documentation

• MCP Server (Hosted) — setup guides for Cursor, Claude Code, Claude Desktop, Windsurf
• Self-Hosted MCP — run locally with npx, environment variables, library usage
• Authentication — signature-based vs API Key Only
• Run a Model — how the Run endpoint works
• Tasks — task lifecycle, statuses, determining success
• Concurrency Limits — concurrent task limits based on balance
• Error Reference — error codes and handling

Using as a Library

This package exports its core components for use in custom MCP servers:

import { createMcpServer, WiroClient } from '@wiro-ai/wiro-mcp';

const client = new WiroClient('your-api-key', 'your-api-secret');
const server = createMcpServer(client);

Exports

| Export | Description | |--------|-------------| | createMcpServer(client) | Creates an McpServer with all 11 tools registered | | WiroClient | API client with both auth types | | registerTools(server, client) | Register tools on an existing McpServer |

// Import specific components
import { WiroClient } from '@wiro-ai/wiro-mcp/client';
import { registerTools } from '@wiro-ai/wiro-mcp/tools';

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | WIRO_API_KEY | Yes | Your Wiro project API key | | WIRO_API_SECRET | No | Your Wiro project API secret (for signature auth) | | WIRO_API_BASE_URL | No | Override API base URL (default: https://api.wiro.ai/v1) |

Links

• Wiro AI
• Dashboard
• Models
• API Documentation
• Create Project

License

MIT — see [LICENSE](./LICENSE) for details.

---

Built with ❤️ by the Wiro team

🌐 wiro.ai · GitHub @wiroai

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: wiroai
• Source: wiroai/Wiro-MCP
• License: MIT
• Homepage: https://wiro.ai/docs/wiro-mcp-server

Install and usage instructions live in the source repository linked above.