Connect Your Own AI Agent or Software to Tolk2Go
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.
- Add the MCP server
https://api.tolk2go.com/api/v1/mcpto the client. - 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.
- 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.
- Use the Tolk2Go account the bookings belong to. New? Create an account first.
- 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.
- 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.
- 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.