MCP server
Tookan MCP by usefulapi
Read Tookan tasks, agents, teams and customers; create delivery tasks and assign agents.
- Runs
- Remotely
- Version
- 1.32.0
- Listing updated
- 4 days ago
About Tookan MCP by usefulapi
Tookan MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Install
Run in a terminal
claude mcp add --transport http tookan https://tookan.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://tookan.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"tookan": {
"url": "https://tookan.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"tookan": {
"type": "http",
"url": "https://tookan.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"tookan": {
"serverUrl": "https://tookan.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"tookan": {
"type": "http",
"url": "https://tookan.usefulapi.io/mcp"
}
}
}Tools this server provides (15)
Read directly from the server.
- tookan_get_account
- The connected Tookan account (admin user): user_id, email, name, company name and address. Good first call. POST /v2/get_user_details.
- tookan_list_tasks
- List tasks (Tookan calls them jobs) of one task type within a date range of the task date (at most 31 days, within the last 31 days). Paginated: one Tookan page per call (page, default 1). Filter by status, agent (fleet_id), team, customer, job ids or your order ids. Task status codes: 0 assigned, 1 started, 2 successful, 3 failed, 4 in progress/arrived, 6 unassigned, 7 accepted/acknowledged, 8 de
- tookan_get_tasks
- Full details of up to 100 tasks by job id: customer, addresses, agent (fleet_id/fleet_name), status, timestamps (started/arrived/completed), tracking link, custom fields; optionally the status history. Task status codes: 0 assigned, 1 started, 2 successful, 3 failed, 4 in progress/arrived, 6 unassigned, 7 accepted/acknowledged, 8 declined, 9 cancelled, 10 deleted. POST /v2/get_job_details.
- tookan_get_tasks_by_order_id
- Full details of the tasks carrying the given order ids (the reference you set when creating a task). POST /v2/get_job_details_by_order_id.
- tookan_get_task_stats
- Task counts per status (e.g. successful vs failed), optionally for one task type, one team and a date range. Task status codes: 0 assigned, 1 started, 2 successful, 3 failed, 4 in progress/arrived, 6 unassigned, 7 accepted/acknowledged, 8 declined, 9 cancelled, 10 deleted. POST /v2/user_task_stats.
- tookan_list_agents
- List agents (drivers / field workers; Tookan calls them fleets) with fleet_id, name, phone, tags, team and live status (0 available, 1 offline, 2 busy). Filter by name, tags, availability or fleet ids. The API returns the whole list; this tool returns a window (limit/offset, next_offset). POST /v2/get_all_fleets.
- tookan_get_agent
- One agent's profile (name, email, phone, tags, transport, location, rating, active state) and current tasks. Only profile fields are returned; app tokens and password hashes never are. POST /v2/view_fleet_profile.
- tookan_get_agent_location
- An agent's last known coordinates (latitude/longitude). POST /v2/get_fleet_location.
- tookan_list_teams
- List teams (team_id, name, address, tags). With include_agents, each team also lists its agents. Returns a window (limit/offset, next_offset). POST /v2/view_all_team_only (or /v2/view_teams with agents).
- tookan_list_customers
- List customers (customer_id, name, phone, email, address), optionally searched by name or phone. Paginated: one Tookan page per call (page, default 1). POST /v2/get_all_customers.
- tookan_find_customer_by_phone
- Find customers by exact phone number. POST /v2/find_customer_with_phone.
- tookan_get_customer
- One customer's profile (contact details, address, coordinates). POST /v2/view_customer_profile.
- tookan_create_delivery_task
- WRITE: create a delivery task (job) for a customer address, due by job_delivery_datetime in the given timezone. Optionally assign it to an agent (fleet_id) or team, or let Tookan auto-assign it within the team. Returns job_id and tracking link. Always uses the address given here, not one saved for the customer's phone (ignore_customer_lat_long 1). POST /v2/create_task (has_pickup 0, has_delivery 1
- tookan_assign_agent_to_task
- WRITE: assign (or reassign) a task to an agent of a team; replaces any previous agent. Notifies the agent unless notify is false (so repeating the call notifies again). POST /v2/assign_fleet_to_task.
- tookan_update_task_status
- WRITE (DESTRUCTIVE): force a task's status, overriding the agent app. Completing (2 successful, 3 failed) or cancelling (9) closes the task and notifies per the account's settings; confirm with the user first. Deleting (10) is not offered. Settable: 0 assigned, 1 started, 2 successful, 3 failed, 4 arrived, 6 unassigned, 7 accepted, 8 declined, 9 cancelled. POST /v2/update_task_status.
Tookan MCP by usefulapi FAQ
How do I add Tookan MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http tookan https://tookan.usefulapi.io/mcp