Tolk2Go Interpreter Booking

Official7 tools

by Tolk2Go-Organization

Book and manage sworn and qualified interpreters (on-site, phone, video) for a Tolk2Go account.

MCP Server: com.tolk2go/booking

This MCP server enables booking and management of sworn and qualified interpreters for a Tolk2Go account. Interpreter delivery modes covered include on-site, phone, and video. The server is identified by the slug com-tolk2go-booking and described as com.tolk2go/booking.

🛠️ Key Features

Booking of sworn and qualified interpreters
Interpreter management for a Tolk2Go account
Support for on-site, phone, and video interpreting

🚀 Use Cases

Schedule sworn or qualified interpreters for on-site meetings
Arrange phone interpreting sessions via a Tolk2Go account
Set up video interpreting for events requiring qualified language support

⚡ Developer Benefits

Clear account-scoped workflow tied to “Tolk2Go account”
Explicit interpreter modalities (on-site, phone, video) for integration logic

⚠️ Limitations

No additional capabilities (e.g., specific MCP tools, availability, authentication details) are described in the provided data.

Topics

agent-skillsbookinginterpretersmcpmcp-server

Captured live from the server via tools/list.

tolk2go_interpreting_list_bookings

List this account’s interpreter bookings, optionally returning only changes after a timestamp or cursor.

Parameters3

updated_since	string	optional
cursor	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "updated_since": {
      "type": "string"
    },
    "cursor": {
      "type": "string"
    },
    "limit": {
      "default": 25,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

tolk2go_interpreting_get_booking

Read the authoritative owner-scoped booking, payment, change and next-action state.

Parameters1

booking_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "booking_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

tolk2go_interpreting_get_responses

Read interpreters who responded as available for an owned booking request.

Parameters1

booking_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "booking_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

tolk2go_interpreting_create_booking

Create an owner-scoped interpreter request. Use public REST catalogue and availability endpoints first.

Parameters12

idempotency_key	string	required
language_pair_id	string	required
situation_id	string	required
start	string	required
end	string	required
type	string	required
phone_type	string	optional
bookingTimezone	string	optional
location	object	optional
description	string	optional
client_reference	string	optional
preferred_interpreter_ids	array	required

Raw schema

{
  "type": "object",
  "properties": {
    "idempotency_key": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "language_pair_id": {
      "type": "string",
      "minLength": 1
    },
    "situation_id": {
      "type": "string",
      "minLength": 1
    },
    "start": {
      "type": "string",
      "minLength": 1
    },
    "end": {
      "type": "string",
      "minLength": 1
    },
    "type": {
      "type": "string",
      "enum": [
        "phone",
        "address"
      ]
    },
    "phone_type": {
      "type": "string"
    },
    "bookingTimezone": {
      "type": "string"
    },
    "location": {
      "type": "object",
      "properties": {
        "lat": {
          "type": "number"
        },
        "lng": {
          "type": "number"
        },
        "address": {
          "type": "string"
        }
      },
      "required": [
        "lat",
        "lng",
        "address"
      ]
    },
    "description": {
      "type": "string"
    },
    "client_reference": {
      "type": "string"
    },
    "preferred_interpreter_ids": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "idempotency_key",
    "language_pair_id",
    "situation_id",
    "start",
    "end",
    "type",
    "preferred_interpreter_ids"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

tolk2go_interpreting_select_interpreter

Select an available interpreter for an owned request; this may create a payment next action.

Parameters3

booking_id	string	required
interpreter_id	string	required
idempotency_key	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "string",
      "minLength": 1
    },
    "interpreter_id": {
      "type": "string",
      "minLength": 1
    },
    "idempotency_key": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    }
  },
  "required": [
    "booking_id",
    "interpreter_id",
    "idempotency_key"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

tolk2go_interpreting_request_change

Submit supported changes through the existing customer approval flow.

Parameters3

booking_id	string	required
changes	object	required
idempotency_key	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "string",
      "minLength": 1
    },
    "changes": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "idempotency_key": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    }
  },
  "required": [
    "booking_id",
    "changes",
    "idempotency_key"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

tolk2go_interpreting_cancel_booking

Cancel an owned interpreter booking.

Parameters3

booking_id	string	required
reason	string	optional
idempotency_key	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "string",
      "minLength": 1
    },
    "reason": {
      "type": "string"
    },
    "idempotency_key": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    }
  },
  "required": [
    "booking_id",
    "idempotency_key"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md3 KBView on GitHub

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.

bash

curl -s -X POST https://api.tolk2go.com/api/v1/login \
  -H 'Content-Type: application/json' \
  -d '{"email":"you@example.com","password":"..."}'

Use that token to issue a durable agent key (default 90 days, 7–365 allowed). The plaintext key is shown once:

bash

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 key in your client's secret store and send it as Authorization: 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

json

{
  "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.

Tool	Purpose
`tolk2go_interpreting_list_bookings`	List the account's bookings, or only changes since a timestamp/cursor
`tolk2go_interpreting_get_booking`	Read booking, payment, change and next-action state
`tolk2go_interpreting_get_responses`	Read interpreters who responded as available
`tolk2go_interpreting_create_booking`	Create an interpreter request
`tolk2go_interpreting_select_interpreter`	Select an available interpreter (may return a payment link)
`tolk2go_interpreting_request_change`	Submit a change through the customer approval flow
`tolk2go_interpreting_cancel_booking`	Cancel a booking

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

bash

npx skills add Tolk2Go-Organization/agent-skills

Or copy skills/booking-tolk2go-interpreters/SKILL.md into your agent's skills directory.

Support

support@tolk2go.com · Terms

Install

Tools (7)

tolk2go_interpreting_list_bookingstolk2go_interpreting_get_bookingtolk2go_interpreting_get_responsestolk2go_interpreting_create_bookingtolk2go_interpreting_select_interpretertolk2go_interpreting_request_changetolk2go_interpreting_cancel_booking

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://api.tolk2go.com/api/v1/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "booking": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.tolk2go.com/api/v1/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

MCP Server: com.tolk2go/booking

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

tolk2go_interpreting_list_bookings

tolk2go_interpreting_get_booking

tolk2go_interpreting_get_responses

tolk2go_interpreting_create_booking

tolk2go_interpreting_select_interpreter

tolk2go_interpreting_request_change

tolk2go_interpreting_cancel_booking

Tolk2Go agent access

How access works

Connect an MCP client

Install the agent skill

Support

Install

Remote endpoint

Related servers