Torii ships a Model Context Protocol (MCP) server that lets AI assistants like Claude and ChatGPT securely query and act on your Torii data — your apps, users, contracts, workflows, and more — using your existing Torii account and permissions.

This article covers what MCP is, where the Torii MCP endpoint lives, and how to connect popular AI clients to it.

What is MCP?

Model Context Protocol is an open standard that lets AI assistants connect to external data sources and tools through a common interface. You can think of it as a "USB-C port for AI" — instead of every AI vendor building bespoke integrations, any MCP-compatible client can talk to any MCP server.

When you connect Torii's MCP server to your AI assistant, the assistant can:

• Search and read your apps, users, and contracts
• List workflows, audit logs, and transactions
• Run tools like match_apps, search_apps, run_workflow, and others
• Take actions you've granted it (e.g., update a user, create a contract)

Everything respects your Torii role and permissions — the MCP server uses the same access controls as the Torii UI.

Torii MCP server URL

https://api.toriihq.com/mcp

Connecting to popular clients

Claude.ai (web)

1. Open Settings → Connectors (or Settings → Integrations, depending on your plan).
2. Click Add custom connector.
3. Paste the Torii MCP URL: https://api.toriihq.com/mcp
4. Click Connect and sign in with your Torii account when redirected.
5. Approve the consent screen.

Once connected, you can ask Claude things like:

• "Which apps in Torii have more than 100 users?"
• "Show me contracts renewing in the next 60 days."
• "List workflows that ran in the last 7 days."

Claude Desktop

Claude Desktop supports remote MCP servers on Pro, Team, and Enterprise plans.

1. Open Settings → Connectors → Add custom connector.
2. Enter:
   • Name: Torii
   • URL: https://api.toriihq.com/mcp
3. Click Add and complete the OAuth sign-in.

Claude Code

Add Torii as a remote MCP server from the terminal:

claude mcp add --transport http torii https://api.toriihq.com/mcp

The first time you use a Torii tool, Claude Code will open a browser for OAuth sign-in.

Connecting ChatGPT

ChatGPT supports remote MCP servers via Connectors on Plus, Pro, Business, and Enterprise plans.

1. In ChatGPT, open Settings → Connectors.
2. Click Create (or Add custom connector in Developer Mode).
3. Enter:
   • Name: Torii
   • MCP Server URL: https://api.toriihq.com/mcp
   • Authentication: OAuth
4. Save and connect — ChatGPT will redirect you to sign in to Torii.
5. In a new chat, enable the Torii connector from the tools menu.

ChatGPT's MCP connector availability evolves quickly. If you don't see the option, check OpenAI's connectors documentation for the latest UI.

Connecting other MCP clients

Any client that supports remote MCP servers with OAuth can connect to Torii. Common examples:

• Cursor — Settings → MCP → Add new MCP server (HTTP transport)
• Windsurf, Zed, Cline, Continue — see each tool's MCP configuration
• Custom apps — use the official MCP SDKs

Generic configuration

Most clients accept the same three values:

For clients that use a JSON config file, the entry typically looks like:

{
  "mcpServers": {
    "torii": {
      "url": "https://api.toriihq.com/mcp",
      "type": "http"
    }
  }
}

The first request will trigger an OAuth sign-in flow in your browser.

Permissions and security

Scoped to your account: the MCP server acts on your behalf and respects your Torii role.