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 for details.

---