Tolk2Go agent access
Tolk2Go connects customers with sworn and qualified interpreters for on-site, phone and video assignments. This repository lets AI agents book and manage Tolk2Go interpreters on behalf of a customer account.
- MCP server:
https://api.tolk2go.com/api/v1/mcp(Streamable HTTP) - REST API (OpenAPI 3):
https://api.tolk2go.com/api/v1/spec - Agent guide:
https://www.tolk2go.com/llms.txt - Agent skill:
skills/booking-tolk2go-interpreters
How access works
Search is public. Booking actions belong to a customer account and use an agent key:
-
Create an account at tolk2go.com or via
POST /api/v1/register. -
Log in once to get a 5-minute token:
curl -s -X POST https://api.tolk2go.com/api/v1/login \ -H 'Content-Type: application/json' \ -d '{"email":"[email protected]","password":"..."}' -
Use that token to issue a durable agent key (default 90 days, 7–365 allowed). The plaintext key is shown once:
curl -s -X POST https://api.tolk2go.com/api/v1/agent-access-keys \ -H "Authorization: Bearer $LOGIN_TOKEN" \ -H 'Content-Type: application/json' \ -d '{"name":"My assistant","expires_in_days":90}' -
Store the returned
keyin your client's secret store and send it asAuthorization: Bearer <key>.
Keys can be listed, rotated and revoked with a fresh login token. Losing a key never locks you out: log in again and issue a new one.
Connect an MCP client
{
"mcpServers": {
"tolk2go": {
"type": "http",
"url": "https://api.tolk2go.com/api/v1/mcp",
"headers": { "Authorization": "Bearer t2g_agent_..." }
}
}
}
initialize and tools/list work without a key, so you can inspect the tools first. Every tool call requires a valid key.
Find languages, situations and available interpreters with the public REST endpoints first. The skill and llms.txt describe the full
journey.
Install the agent skill
npx skills add Tolk2Go-Organization/agent-skills
Or copy skills/booking-tolk2go-interpreters/SKILL.md into your agent's skills directory.