@uniohq/mcp-server

Model Context Protocol server for the Unio agent tool registry. Plugs into Claude Desktop, Claude Code, Cursor, Zed, or any other MCP-compatible AI and gives the model four tools for discovering and integrating SaaS APIs without leaving the chat.

npm install -g @uniohq/mcp-server
# or use npx — no install required
npx @uniohq/mcp-server

What it does

When you wire this MCP server into your assistant, the model gains four tools:

| Tool | Purpose | | --- | --- | | unio_search | Semantic intent search over the Unio registry. Ranked results with pricing + health. | | unio_get_manifest | Full unio.json manifest for a service: capabilities, auth, signup endpoint. | | unio_inspect_capability | Schema + example request/response + ready-to-run curl for a single capability. | | unio_get_sdk_snippet | Generates Python or TypeScript code that signs up and calls the capability. |

The whole flow: the model can go from "I need to send transactional email" to running, integration-ready code in three tool calls.

Setup — Claude Desktop

Edit claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "unio": {
      "command": "npx",
      "args": ["@uniohq/mcp-server"],
      "env": {
        "UNIO_API_BASE": "https://xza0g37re9.execute-api.ap-south-1.amazonaws.com/prod"
      }
    }
  }
}

Restart Claude Desktop. You should see a 🔌 icon with unio listed and 4 tools available.

Setup — Claude Code

Edit ~/.claude/mcp_config.json (or use claude mcp add unio):

{
  "mcpServers": {
    "unio": {
      "command": "npx",
      "args": ["@uniohq/mcp-server"],
      "env": {
        "UNIO_API_BASE": "https://xza0g37re9.execute-api.ap-south-1.amazonaws.com/prod"
      }
    }
  }
}

Setup — Cursor

In .cursor/mcp.json at your project root:

{
  "mcpServers": {
    "unio": {
      "command": "npx",
      "args": ["@uniohq/mcp-server"]
    }
  }
}

How a session typically goes

You:    Build me an agent that sends a transactional welcome email.
Claude: [calls unio_search { intent: "send transactional email" }]
        I found Resend and Loops on the Unio registry. Both have free tiers.
        Which would you like to use?
You:    Resend.
Claude: [calls unio_get_manifest { service_id: "resend" }]
        [calls unio_inspect_capability { service_id: "resend", capability_id: "send_email" }]
        [calls unio_get_sdk_snippet { service_id: "resend", capability_id: "send_email", language: "python" }]
        Here's a runnable script — it onboards your agent with Resend
        programmatically and sends the welcome email.

Environment variables

| Variable | Default | Purpose | | --- | --- | --- | | UNIO_API_BASE | https://xza0g37re9.execute-api.ap-south-1.amazonaws.com/prod | Base URL of the Unio registry. Override for staging or self-hosted. |

License

Apache-2.0