<link rel="stylesheet" href="assets/fontawesome/css/all.min.css" />

Connect Your Own AI Agent or Software to Tolk2Go

In short: This page is for IT departments and developers. It explains how to connect an AI tool other than ChatGPT or Claude, or your own software, to a Tolk2Go customer account, so it can search, book and follow up interpreters. Using ChatGPT or Claude? Follow the simple steps under AI agent access in your account, and see Book interpreters with your AI agent for what your assistant can do.

What you can connect

  • Other AI tools, such as Microsoft Copilot, Gemini or Cursor.
  • Agent builders, such as n8n or Zapier.
  • Your own chatbot or assistant.
  • Your own software, such as a planning or case management system, that books interpreters directly through the Tolk2Go API, without an AI.

AI tools connect to the Tolk2Go MCP server (Model Context Protocol over Streamable HTTP). Your own software uses the REST API, described in an OpenAPI contract. Searching languages, situations and available interpreters is public and needs no sign-in. Booking always works on behalf of one Tolk2Go customer account.


Sign in with OAuth

For MCP clients that support OAuth sign-in. No key is needed.

  1. Add the MCP server https://api.tolk2go.com/api/v1/mcp to the client.
  2. Sign in and allow. The client opens a Tolk2Go page. The user logs in with their Tolk2Go customer account and chooses Allow access. The password stays with Tolk2Go.
  3. Disconnect at any time under AI agent access in the account.

Tolk2Go supports OAuth 2.1 with PKCE and dynamic client registration. The authorization server metadata is at https://api.tolk2go.com/.well-known/oauth-authorization-server.


Connect with an agent key

For clients without OAuth support and for your own software on the REST API.

  1. Use the Tolk2Go account the bookings belong to. New? Create an account first.
  2. Create an agent key. Log in and open AI agent access in the account, choose Create key and copy the key. It is shown only once: store it in the client's secret settings, never in a chat or prompt.
  3. Connect the client to the Tolk2Go MCP server with the key (example configuration below), or give it the OpenAPI contract. A client can also issue a key itself after logging in once through the API.
  4. Replace or revoke the key at any time under AI agent access. A revoked key stops working immediately.

Addresses

What Address
MCP server (Streamable HTTP) https://api.tolk2go.com/api/v1/mcp
OpenAPI contract https://api.tolk2go.com/api/v1/spec
Guide for AI agents https://www.tolk2go.com/llms.txt
Agent skill and setup examples github.com/Tolk2Go-Organization/agent-skills

Example MCP client configuration with an agent key:

{
  "mcpServers": {
    "tolk2go": {
      "type": "http",
      "url": "https://api.tolk2go.com/api/v1/mcp",
      "headers": { "Authorization": "Bearer t2g_agent_..." }
    }
  }
}

Want the full booking journey in your agent at once? Install the Tolk2Go agent skill with npx skills add Tolk2Go-Organization/agent-skills.


Security

  • One account only. A connected app or an agent key can only see and manage the bookings of the account that connected it.
  • Shown once, stored securely. An agent key is displayed only when it is issued. Tolk2Go stores only a secure hash, never the key itself.
  • Limited lifetime. Keys are valid for 90 days by default (7 to 365 days can be chosen), so an agent can come back weeks later without logging in again.
  • Rotate, revoke or disconnect at any time. Under AI agent access the customer sees every key with its last use and every connected app, and replaces or revokes a key or disconnects an app with one click.
  • Never locked out. Lost a key? Revoke it in the account and create a new one. The normal account login always keeps working.
  • No payments by the agent. When payment upfront is required, the agent gets a secure payment link for the customer.

Frequently Asked Questions

Which clients are supported?

Any assistant or agent that supports the Model Context Protocol (MCP) over Streamable HTTP, with OAuth sign-in or an agent key, and any software that can call a REST API described in OpenAPI.

What happens if an agent key is lost or leaked?

Log in, revoke the key under AI agent access in the account, and create a new one. The revoked key stops working, and it could only ever access the bookings of that one account.

Can our own software book without an AI assistant?

Yes. The REST API offers the same search, booking and follow-up as the MCP server. See the OpenAPI contract above.


Need help connecting?

We are happy to help your IT department or developer connect Tolk2Go.