Torii MCP Server

A Model Context Protocol (MCP) server for Torii — the SaaS management platform. It provides tools that AI assistants can use to query apps, users, contracts, roles, audit logs, and more.

Setup

You need a Torii API key. Get one from your Torii admin settings.

Claude Desktop

1. Open Claude Desktop Settings > Developer > Edit Config
2. Add to claude_desktop_config.json:

{
  "mcpServers": {
    "torii": {
      "command": "npx",
      "args": ["-y", "@toriihq/torii-mcp"],
      "env": {
        "TORII_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

3. Restart Claude Desktop

Cursor

1. Open Cursor Settings > MCP > Add new global MCP Server
2. Select type "command" and add:

{
  "mcpServers": {
    "torii": {
      "command": "npx",
      "args": ["-y", "@toriihq/torii-mcp"],
      "env": {
        "TORII_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

3. Click Save

Other MCP Clients

Any MCP-compatible client can use this server. The configuration is the same — run npx -y @toriihq/torii-mcp with the TORII_API_KEY environment variable set.

Available Tools

| Tool | Description | |------|-------------| | get_org_info | Get organization info (name, domain) — verify your connection | | list_apps | List apps with filtering, sorting, aggregations, and pagination | | get_app | Get a specific app by ID | | get_app_fields | List available fields for app queries | | get_app_users | List users of a specific app | | list_users | List users with filtering, sorting, aggregations, and pagination | | get_user | Get a specific user by ID | | get_user_fields | List available fields for user queries | | get_user_apps | List apps a specific user has access to | | list_contracts | List all contracts | | get_contract | Get a specific contract by ID | | get_contract_fields | List available fields for contract queries | | list_roles | List all admin roles | | get_audit_logs | Retrieve audit logs with filtering by entity and time range |

Example Questions

• What apps does my organization use?
• Who has admin access?
• What contracts are expiring in the next 30 days?
• Show me all apps added last month
• How many users are using Slack?

Configuration

| Environment Variable | Required | Description | |---------------------|----------|-------------| | TORII_API_KEY | Yes | Your Torii API key | | TORII_API_URL | No | Custom API base URL (default: https://api.toriihq.com/v1.0) |

Developing

Prerequisites

• Node.js v16+
• yarn

Setup

yarn install
yarn build

Run locally

export TORII_API_KEY=your_api_key
yarn start       # production
yarn dev         # watch mode

Inspect with MCP Inspector

yarn inspect

License

UNLICENSED