How it works
Connect custom MCP servers in Orchestrivo or connect apps from your Connectors page (Customize > Connectors). The server catalog includes Orchestrivo-hosted servers, user-deployed Orchestrivo Controls servers, and custom MCP servers, each with a connection status.1
List connected and available servers
Call
list_mcp_servers to browse the servers in the catalog and their connection status.2
Inspect a server's tools
Call
list_mcp_server_tools with the server_id to see the tools and connection status. If it isn’t connected, open the returned orchestrivo_auth_url to finish connecting.3
Call a tool
Call
call_mcp_tool with server_id, tool_name, and arguments. Include the optional ref to have it echoed in the results.list_teams to find team IDs. For team-owned connections, pass the team ID as project_id.
Other MCP capabilities include:
- List resources with
list_mcp_resourcesand read them withread_mcp_resource. - List prompts with
list_mcp_promptsand render them withget_mcp_prompt.
call_mcp_tool with these arguments to list five recent emails through a Gmail connection:
Example prompts
Using my Gmail connection in Orchestrivo, find unread emails from today.
Create a Linear issue through Orchestrivo for the bug we discussed, and assign it to me.
Search my Slack messages through Orchestrivo for the latest project update.
Use my connected Notion tools through Orchestrivo to find the launch checklist.
Governance
Tool calls made through the Orchestrivo MCP server follow the same connector governance as tool calls made by Orchestrivo agents.- Credentials stay in Orchestrivo. Tools run inside Orchestrivo. Your MCP client receives tool results, never the app’s OAuth tokens.
- Custom roles. If a custom role blocks an app or a specific tool,
list_mcp_serversshows that server as blocked andcall_mcp_toolrejects the call. - App Rules. Organization App Rules run on each call and can block it based on the tool and its arguments.
- Account restrictions. Domain restrictions and App Claims control which accounts and workspaces people can connect.
- Activity. Calls appear in Connector Activity, so admins can see who called which tool, from which source, and whether it succeeded.