Hawky API Documentation

One command

claude mcp add --transport http hawky https://hawky.tech/mcp \
  --header "Authorization: Bearer %%TOKEN%%"

Use it

> @hawky show me every truck idling more than 15 minutes in CDMX

No token? Leave the header off and the agent will ask for credentials via the hawky_login tool on first use.

Edit claude_desktop_config.json

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "hawky": {
      "url": "https://hawky.tech/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer %%TOKEN%%"
      }
    }
  }
}

Restart Claude Desktop — the 🔨 tools icon will list hawky_* tools.

Edit ~/.cursor/mcp.json (or project .cursor/mcp.json)

{
  "mcpServers": {
    "hawky": {
      "url": "https://hawky.tech/mcp",
      "headers": {
        "Authorization": "Bearer %%TOKEN%%"
      }
    }
  }
}

Cursor → Settings → MCP → "hawky" appears with 19 tools.

Edit ~/.codex/config.toml

[mcp_servers.hawky]
url = "https://hawky.tech/mcp"

[mcp_servers.hawky.headers]
Authorization = "Bearer %%TOKEN%%"

Start a session — list tools with /mcp.

List tools

curl -s https://hawky.tech/mcp \
  -H "Authorization: Bearer %%TOKEN%%" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Call a tool (live fleet positions)

curl -s https://hawky.tech/mcp \
  -H "Authorization: Bearer %%TOKEN%%" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"hawky_get_devices_latest"}}'

Any MCP-compatible client that supports remote HTTP transport can connect — just point it at https://hawky.tech/mcp.

Log in to use the API

Authenticated