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.

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"

Related MCP server: PostIdentity MCP Server

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

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

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

Environment Variables

Links

• Wiro AI

• Dashboard

• Models

• API Documentation

• Create Project

License

MIT — see LICENSE for details.

Built with ❤️ by the Wiro team

🌐 wiro.ai · GitHub @wiroai