Connect an assistant

You can drive fOS from an external assistant — Claude, ChatGPT, or any client that speaks the Model Context Protocol — so it can search loads, read economics, and act on your behalf from inside that assistant. This guide is the quick path; the full spec is the Agent API reference.

What you need

• An fOS API key (tovr_…), or an MCP client that supports the OAuth browser flow.
• The MCP endpoint: https://mcp.tovr.eu/mcp.

Connect an MCP client

1. Add a custom MCP server in your assistant, pointing at https://mcp.tovr.eu/mcp.
2. Authenticate:
   • API key — provide your tovr_… key as a bearer token, or
   • OAuth — clients that support it auto-discover the OAuth configuration and open a browser consent flow (OAuth 2.1 with PKCE).
3. If you belong to more than one organization, fOS will establish which one is in context via list_my_orgs / switch_org before acting.

Once connected, the assistant can call the tools flagged MCP ✓ in the tool reference — chiefly the decision-grade reads plus a controlled set of actions.

What the assistant can and can't do

Exposure is deliberately scoped on this surface: reads are broadly available, writes are gated, and some sensitive actions (like connecting an integration) never leave the TOVR web app. See Guardrails › scoped exposure.

Non-MCP clients

If your client doesn't speak MCP, use the REST bridge: GET /api/v1/tools to list tools and POST /api/v1/tools/{toolName} to invoke one, with the same authentication and scopes.