# Wiro-MCP [Health: Active]

**Category:** 🗣️ Conversational AI  
**Repository:** https://github.com/wiroai/Wiro-MCP  
**GitHub Stars:** 4  
**npm Downloads (last month):** 2161  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/wiro-mcp

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

## Tools
Capabilities this server exposes over MCP:

- **search_models** — Search and browse AI models by keyword, category, or owner
- **get_model_schema** — Get full parameter schema and pricing for any model, or the parameters and output ports of a workflow utility
- **recommend_model** — Find models for a goal from two or three key words, best matches first
- **explore** — Browse curated models grouped by category, no parameters needed
- **run_model** — Run any model, waiting up to 45s by default before it returns a recoverable task token
- **wait_for_task** — Continue waiting for an existing task without submitting or billing a duplicate run
- **get_task** — Check task status immediately or wait up to 45s with `wait_seconds
- **list_tasks** — Browse authenticated task history across conversations, then continue with `get_task
- **get_task_price** — Get the cost of a completed task
- **cancel_task** — Cancel a queued task
- **kill_task** — Stop a queued or running task
- **upload_file** — Upload a file from a public http(s) URL (up to about 100 MB) for use as model input
- **list_workflows** — List the workflows in your workspace, or search the public gallery by text, tag or model
- **get_workflow** — Read a workflow's inputs, outputs and step graph
- **create_workflow** — Save a new workflow from a step graph. Wiro checks it against the live model catalog and returns every problem it finds at once
- **update_workflow** — Edit a workflow's title, description, tags or graph without overwriting newer changes; a new graph is saved only after you confirm a summary of the change
- **clone_workflow** — Copy a public workflow into your workspace
- **delete_workflow** — Delete a workflow, after your confirmation
- **run_workflow** — Run a workflow and wait for its outputs; can stop after a chosen step to test the first steps
- **wait_for_workflow_run** — Keep waiting on a run, read its outputs, or see why a step failed
- **resume_workflow_run** — Continue a failed or stopped run without paying again for finished steps
- **list_workflow_runs** — Browse past and current runs, including runs started on wiro.ai
- **save_workflow_from_agent** — Save a workflow the Workflow Agent proposed, as a new workflow, or onto an existing one after you confirm a summary of the change
- **send_agent_message** — Send a message and wait for the reply, with any media, workflows or model runs it produced
- **get_agent_message** — Keep waiting on a reply, or read one again
- **get_agent_conversation** — List conversations, or read one conversation's history
- **cancel_agent_message** — Stop a reply that is still being written
- **delete_agent_session** — Delete a conversation and the agent's memory of it, after your confirmation
- **list_studio_results** — List the images, videos and other results Studio generated for you
- **list_agent_templates** — Browse ready-made agent templates and their monthly prices
- **get_agent_template** — Read a template's skills, plans, and the accounts and keys it needs
- **list_agent_skills** — Browse the skills an agent can have, and what each one needs to work
- **deploy_agent** — Deploy an agent from a template or build one from skills; shows the price, the wallet it charges and the other tier's price, and asks before charging
- **list_my_agents** — List your agents with their status, plan and credits
- **get_my_agent** — Read one agent's setup, plan and credits; can wait until it is running
- **control_agent** — Start, stop or restart an agent
- **update_agent** — Change an agent's name, description, time zone, models and chat commands
- **apply_agent_skills** — Turn skills on or off; shows the price change and asks before charging
- **set_agent_credentials** — Save the keys, tokens and settings an agent's skills and channels need, such as a Telegram bot token or a Gmail app password
- **connect_agent_oauth** — Connect sign-in accounts such as HubSpot or X for the services an agent's skills use; you approve the connection in your browser. Some services need your own app keys or a token first
- **disconnect_agent_oauth** — Disconnect a connected account, after your confirmation
- **list_projects** — List the projects of the connected project's workspace, to pick one for an agent; no keys are shown
- **bind_agent_project** — Connect an agent to a Wiro project so it can run models, with no key in the chat; shows the project first, then asks for your confirmation
- **manage_agent_custom_skill** — Add, edit, schedule, restore or remove an agent's own instructions and scheduled tasks; turning off its approval policy or changing its rules needs your confirmation
- **manage_agent_billing** — Subscribe, upgrade to Pro, cancel, renew or buy extra credits from your wallet, after your confirmation
- **get_agent_activity** — Read an agent's credit usage and activity logs, including who changed what on it
- **delete_agent** — Delete an agent, after your confirmation
- **get_account** — Show which workspace the connected project belongs to, its wallet balance and, when you ask, the wallet's recent transactions
- **get_playbook** — Step-by-step guides: getting started, models, workflows, workflow graphs, the Workflow Agent, Studio, agents and billing
- **search_docs** — Search the Wiro documentation for guides and API references

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "wiro-mcp": {
    "command": "npx",
    "args": ["-y","@wiro-ai/wiro-mcp"],
    "env": {
      "WIRO_API_KEY": "",
      "WIRO_API_SECRET": ""
    }
  }
}
```

**Requires environment variables:** `WIRO_API_KEY`, `WIRO_API_SECRET` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What Wiro-MCP does

Wiro-MCP exposes Wiro AI capabilities as Model Context Protocol tools. Assistants can search the model catalog, compare models for a stated goal, inspect input schemas and pricing, and run models for image, video, audio, or language tasks. The server also provides access to task history, result pricing, cancellation, and file upload from a public HTTP(S) URL.

Its second major area is workflow automation. A workflow combines model and utility steps into a graph with defined inputs and outputs. Agents can browse a workspace or public gallery, inspect existing graphs, create or update workflows, clone public workflows, execute them, and resume eligible failed or stopped runs. Workflow Agent proposals can also be saved after confirmation.

The Agents tools support conversations with Wiro's Studio creative agent and access to agent templates. They can send messages, retrieve replies and conversation history, list Studio results, and manage agent sessions.

## How it works

The npm package is a TypeScript MCP server that runs locally over stdio. It can be started with `npx`, allowing an MCP client to launch it as a subprocess. Wiro also hosts the same tool set at `https://mcp.wiro.ai/v1` over streamable HTTP, which avoids installing Node.js locally.

Model and workflow execution can take longer than a single tool call. `run_model` waits for a result for up to 45 seconds by default, then returns a task identifier and recovery token if the work is still running. Continuing with `wait_for_task` avoids submitting and billing a duplicate run. Workflow runs have corresponding wait and resume operations, including the ability to continue after a failure without paying again for completed steps.

Workflows are checked against Wiro's live model catalog when saved. Missing model inputs use the model's defaults, and the save response reports those filled values. Workflow graphs are limited to 40 KB of JSON.

## Setup and configuration

Create a Wiro AI account and project to obtain credentials. Local execution requires Node.js 20 or later. Configure the MCP client to launch `npx -y @wiro-ai/wiro-mcp` and pass the credentials as environment variables.

Signature-based authentication uses `WIRO_API_KEY` and `WIRO_API_SECRET`. API-key-only authentication uses `WIRO_API_KEY` alone, with the secret omitted. For the hosted endpoint, send the credentials as a bearer token: `API_KEY:API_SECRET` for signature-based projects or just `API_KEY` for API-key-only projects.

The server includes documented configurations for Cursor, Claude Code, Claude Desktop, and Windsurf. Remote clients can connect to the hosted endpoint instead of running the local package.

## Tools and capabilities

- Discover models with keyword, category, owner, curated-category, or goal-based searches.
- Read model parameters, output ports, and pricing before running a model or utility.
- Execute models, wait for tasks, inspect task status and history, retrieve completed-task prices, and cancel or stop work.
- Upload public HTTP(S) files of about 100 MB or less as model inputs.
- List, inspect, create, edit, clone, delete, run, and resume workflows.
- Test a workflow through a selected step and inspect failed-step details.
- Save Workflow Agent proposals after reviewing the proposed change.
- Message Studio or other agents, retrieve replies, inspect conversations, cancel replies, delete sessions, and browse generated Studio results.
- Browse agent templates and their monthly prices.

## Limitations and notes

Model runs and completed workflow model steps can incur charges. Retrying a model run after its wait period creates a separate billable task, so existing task identifiers should be continued with the wait tool instead. Workflow deletion and other consequential changes require confirmation through the relevant tool flow. Public-file uploads require an accessible HTTP(S) URL, and workflow graphs cannot exceed 40 KB of JSON.

_Full upstream README: https://allmcps.com/mcp/wiro-mcp/readme_