Wiro AI MCP server
ai.wiro · Updated
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.
One-click install
Opens your editor and pre-fills the config. Your editor will ask before adding it.
How to install Wiro AI in your AI client
Setup for Claude Code, Claude Desktop, Cursor, Codex, Windsurf, Cline and VS Code — copy-paste ready.
How to install Wiro AI in Claude CodeAnthropic's agentic CLI
Add the server
bashclaude mcp add wiro -e 'WIRO_API_KEY=<WIRO_API_KEY>' -e 'WIRO_API_SECRET=<WIRO_API_SECRET>' -- npx -y @wiro-ai/wiro-mcpFill 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.
Verify it's connected
bashclaude mcp listSharing 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).
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 DesktopDesktop app (MCP config)
Open your MCP config
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json
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>" } } } }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.
Restart Claude Desktop
The tools appear under the 🔌 menu once the app reloads.
How to install Wiro AI in CursorAI-first code editor
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>" } } } }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.
Enable it
Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.
How to install Wiro AI in Codex CLIOpenAI coding agent
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>" }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.
Run Codex
Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.
How to install Wiro AI in WindsurfCodeium's agentic IDE
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>" } } } }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.
Reload
Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.
How to install Wiro AI in ClineVS Code autonomous agent
Open Cline → MCP Servers → Configure
Adds to cline_mcp_settings.json.
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>" } } } }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 CodeCopilot / MCP support
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>" } } } }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.
Start it
VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.
What does Wiro AI need from you?
Bearer token — Your Wiro project credentials
WIRO_API_KEYrequiredsecretEnvironment variableAPI key of your Wiro project. Create one at https://wiro.ai/panel/project/new
WIRO_API_SECREToptionalsecretEnvironment variableAPI secret, only for projects that use signature-based auth
AuthorizationrequiredsecretHTTP headerYour Wiro project credentials
Pass secrets through your shell environment rather than committing them into a config file.
What tools does Wiro AI expose? (13)
Taken from the project's README — the server itself was not queried, so check its docs for the exact schemas.
- search_modelsSearch and browse AI models by keyword, category, or owner
- get_model_schemaGet full parameter schema and pricing for any model
- recommend_modelDescribe what you want to build, get model recommendations by relevance
- exploreBrowse curated models organized by category — no parameters needed
- run_modelRun any model — waits up to 45s by default, then returns a recoverable task token
- wait_for_taskContinue waiting for an existing task without submitting or billing a duplicate run
- get_taskCheck task status immediately or wait up to 45s with `wait_seconds`
- list_tasksBrowse authenticated task history across conversations, then continue with `get_task`
- get_task_priceGet the cost of a completed task
- cancel_taskCancel a queued task
- kill_taskKill a running task
- upload_fileUpload a file from URL for use as model input
- search_docsSearch the Wiro documentation for guides and API references
What the code can do
Read from the published package source — never executed. Parsed 24 of 24 source files.
This server can make network requests and read your environment variables.
How it was published
- Published by a verified CI identity (github trusted publishing) rather than a personal token.
- Has a provenance attestation tying this artifact to the commit it was built from.
- 1 npm maintainer — a single point of compromise · last published by GitHub Actions.
Maintainer of this package and think something here is wrong? Tell us and we'll correct it.
Before you install
Signals gathered from the source repo and package registry — not a safety verdict.
What it can reach
- Runs code on your machine — Executes as a local process with your user's permissions, including filesystem access.
- Downloads at launch — The package is fetched from its registry each run unless you pin a version.
- Last commit today — Actively maintained.
- 5 GitHub stars — Very little community usage so far.
Client compatibility
Health score
A · 85Maintenance, adoption, transparency and packaging — not a safety audit. How this is calculated
- Maintenance30%100%
Last commit 0 days ago.
- Adoption20%24%
5 stars.
- Transparency20%100%
4/4: ✓ public source repo, ✓ declared license, ✓ documentation, ✓ discoverable tool list.
- Provenance15%100%
Package and registry entry point at the same repository.
- Packaging15%100%
Publishes a pinned version (1.3.2).
Documentation
Full READMEWiro 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.
Official MCP Server · Self-Hosted MCP · Models · Dashboard · Docs
Quick Start
Local npx and library usage require Node.js 20 or later. The hosted MCP endpoint does not require a local Node.js installation.
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-mcpThen set environment variables WIRO_API_KEY and WIRO_API_SECRET.
Claude Desktop — add to claude_desktop_config.json:
Excerpt — the full document is on GitHub.
Alternatives to Wiro AI
- Wavespeed MCPA · 89Run any model on the live WaveSpeed catalog: image, video, audio, 3D.
- LLMtoMDB · 73Convert PDFs, Office docs, websites and audio into AI-ready Markdown, then search and ask your docs.
- AISTLabsB · 63Video, image and audio generation on top AI models for agents, with an AI director built in.
- NeonA · 93Official Neon MCP server for managing Neon projects and Lakebase Postgres databases.
Maintain Wiro AI? Add a badge to your README
Shows its health grade, and links readers to install steps for every client.
[](https://mcp-skills-hub.vercel.app/mcps/ai-wiro-mcp)Catalog data refreshed . Something wrong? Report it.