# Wiro MCP

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

- **Type:** MCP server
- **Install:** `agentstack add mcp-wiroai-wiro-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [wiroai](https://agentstack.voostack.com/s/wiroai)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [wiroai](https://github.com/wiroai)
- **Source:** https://github.com/wiroai/Wiro-MCP
- **Website:** https://wiro.ai/docs/wiro-mcp-server

## Install

```sh
agentstack add mcp-wiroai-wiro-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Wiro MCP Server

**Official [MCP](https://modelcontextprotocol.io/) server for [Wiro AI](https://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](https://wiro.ai/docs/wiro-mcp-server) · [Self-Hosted MCP](https://wiro.ai/docs/mcp-self-hosted) · [Models](https://wiro.ai/models) · [Dashboard](https://wiro.ai/panel) · [Docs](https://wiro.ai/docs)

## Quick Start

### 1. Get API Keys

Sign up at [wiro.ai](https://wiro.ai/) and create a project at [wiro.ai/panel/project/new](https://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:

```json
{
  "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:**

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

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

```json
{
  "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](https://wiro.ai/docs/wiro-mcp-server) for setup instructions.

## Documentation

- [MCP Server (Hosted)](https://wiro.ai/docs/wiro-mcp-server) — setup guides for Cursor, Claude Code, Claude Desktop, Windsurf
- [Self-Hosted MCP](https://wiro.ai/docs/mcp-self-hosted) — run locally with npx, environment variables, library usage
- [Authentication](https://wiro.ai/docs/authentication) — signature-based vs API Key Only
- [Run a Model](https://wiro.ai/docs/run-a-model) — how the Run endpoint works
- [Tasks](https://wiro.ai/docs/tasks) — task lifecycle, statuses, determining success
- [Concurrency Limits](https://wiro.ai/docs/concurrency-limits) — concurrent task limits based on balance
- [Error Reference](https://wiro.ai/docs/error-reference) — error codes and handling

## Using as a Library

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

```typescript
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 |

```typescript
// 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](https://wiro.ai/)
- [Dashboard](https://wiro.ai/panel)
- [Models](https://wiro.ai/models)
- [API Documentation](https://wiro.ai/docs)
- [Create Project](https://wiro.ai/panel/project/new)

## License

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

---

**Built with ❤️ by the Wiro team**

🌐 [wiro.ai](https://wiro.ai) · [GitHub @wiroai](https://github.com/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](https://github.com/wiroai)
- **Source:** [wiroai/Wiro-MCP](https://github.com/wiroai/Wiro-MCP)
- **License:** MIT
- **Homepage:** https://wiro.ai/docs/wiro-mcp-server

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-wiroai-wiro-mcp
- Seller: https://agentstack.voostack.com/s/wiroai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.