{
  "specVersion": "1.0",
  "host": {
    "identifier": "handset.dev",
    "displayName": "Handset",
    "documentationUrl": "https://docs.handset.dev",
    "logoUrl": "https://handset.dev/icon.svg"
  },
  "entries": [
    {
      "identifier": "urn:air:handset.dev:mcp:handset",
      "displayName": "Handset MCP server",
      "type": "application/mcp-server-card+json",
      "data": {
        "name": "handset",
        "description": "Gives an AI agent a complete business phone system: send and read SMS/MMS, place and inspect calls, manage tenants, numbers, voicemail, and 10DLC compliance on the Handset API.",
        "package": "@handset/mcp",
        "registry": "npm",
        "command": "npx",
        "args": [
          "-y",
          "@handset/mcp"
        ],
        "transport": "stdio",
        "env": {
          "HANDSET_API_KEY": "A Handset API key (hs_test_\u2026 for the free simulated carrier, hs_live_\u2026 for production)"
        },
        "documentation": "https://docs.handset.dev/ai.html"
      },
      "capabilities": [
        "messages",
        "conversations",
        "calls",
        "voicemail",
        "numbers",
        "tenants",
        "compliance"
      ],
      "description": "MCP server for the Handset business phone API. Test mode simulates the whole carrier for free. Machine-readable docs: https://docs.handset.dev/llms.txt (index), https://docs.handset.dev/llms-full.txt (full), https://docs.handset.dev/api.html (OpenAPI reference).",
      "representativeQueries": [
        "text this customer that the technician is on the way",
        "list unread conversations for tenant acme",
        "buy a local number in the 415 area code",
        "summarize yesterday's voicemails"
      ],
      "tags": [
        "telephony",
        "sms",
        "voice",
        "mcp",
        "vertical-saas"
      ],
      "updatedAt": "2026-10-16T00:00:00Z"
    },
    {
      "identifier": "urn:air:handset.dev:skill:handset",
      "displayName": "Handset agent skill",
      "type": "text/markdown; profile=\"urn:air:agent-skills\"",
      "url": "https://docs.handset.dev/ai.html",
      "description": "A SKILL.md that teaches coding agents the Handset patterns: tenant-scoped keys, idempotent sends, webhook verification, test-mode magic numbers. Generate it with `npx -y @handset/mcp --skill`.",
      "representativeQueries": [
        "add two-way texting to my app with Handset",
        "verify a Handset webhook signature",
        "how do I use Handset test mode"
      ],
      "tags": [
        "skill",
        "sdk",
        "telephony"
      ],
      "updatedAt": "2026-10-16T00:00:00Z"
    }
  ]
}
