# Tookan MCP by usefulapi

> Tookan MCP by usefulapi is an MCP server. Read Tookan tasks, agents, teams and customers; create delivery tasks and assign agents. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/tookan/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/tookan
- **MCP Registry name:** io.usefulapi/tookan
- **Listing updated:** 2026-11-13

## About

Read Tookan tasks, agents, teams and customers; create delivery tasks and assign agents.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http tookan https://tookan.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://tookan.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "tookan": {
      "url": "https://tookan.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "tookan": {
      "type": "http",
      "url": "https://tookan.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "tookan": {
      "serverUrl": "https://tookan.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "tookan": {
      "type": "http",
      "url": "https://tookan.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `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.

## 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

---
Source: https://ai-powered.com/mcp/tookan-mcp-by-usefulapi
