# Seven.io — how to use (mcp.ai)

Connect your Seven.io account and use 11 tools for phone and SMS straight from your AI agent. Connect with your own API key. Seven.io provides APIs for SMS, voice, messaging, contacts, phone-number management, and communication analytics.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_seven_io?ms=1787296020000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `seven_io_create_contact`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/seven_io`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/seven_io/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/seven_io/create/contact` — Create a Seven.io contact with identity, address, phone, notes, and group fields.
  - body: { city?: string, email?: string, notes?: string, address?: string, birthday?: string, group_ids?: integer[], last_name?: string, first_name?: string, home_number?: string, postal_code?: string, mobile_number?: string }
- `POST https://api.mcp.ai/api/seven_io/delete/contact` — Permanently delete one Seven.io contact by ID. This is destructive and cannot be undone.
  - body: { contact_id: integer }
- `POST https://api.mcp.ai/api/seven_io/format/phone/numbers` — Validate and normalize one or more phone numbers without performing a paid carrier lookup.
  - body: { numbers: string[] }
- `POST https://api.mcp.ai/api/seven_io/get/analytics` — Return Seven.io usage statistics for a date range, optionally grouped by date, label, subaccount, or country.
  - body: { end?: string, label?: string, start?: string, group_by?: string, subaccounts?: string }
- `POST https://api.mcp.ai/api/seven_io/get/balance` — Return the connected Seven.io account's available credit balance and currency.
- `POST https://api.mcp.ai/api/seven_io/get/sms/pricing` — Return Seven.io SMS prices, preferably narrowed to one destination country.
  - body: { country?: string }
- `POST https://api.mcp.ai/api/seven_io/list/contacts` — List or search Seven.io contacts, optionally restricted to a contact group.
  - body: { limit?: integer, offset?: integer, search?: string, group_id?: integer, order_by?: string, order_direction?: string }
- `POST https://api.mcp.ai/api/seven_io/list/groups` — List Seven.io contact groups and their member counts for use in contact filtering or assignment.
  - body: { limit?: integer, offset?: integer }
- `POST https://api.mcp.ai/api/seven_io/query/message/journal` — Query one page of outbound SMS, inbound SMS, or voice journal entries using a consistent filter interface.
  - body: { to?: string, limit?: integer, state?: string, offset?: integer, date_to?: string, date_from?: string, message_id?: integer, journal_type: string }
- `POST https://api.mcp.ai/api/seven_io/send/sms` — Send an SMS through Seven.io. Live calls contact external recipients and are billable. Sandbox calls validate the request but do not dispatch messages or consume paid products.
  - body: { to: string[], ttl?: integer, from?: string, text: string, delay?: string, flash?: boolean, label?: string, foreign_id?: string, get_replies?: boolean, performance_tracking?: boolean }
- `POST https://api.mcp.ai/api/seven_io/update/contact` — Update selected standard fields or group memberships on an existing Seven.io contact.
  - body: { city?: string, email?: string, notes?: string, address?: string, birthday?: string, group_ids?: integer[], last_name?: string, contact_id: integer, first_name?: string, home_number?: string, postal_code?: string, mobile_number?: string }

## Example prompts
- "What can I do in Seven.io?"
- "Show me a summary of my Seven.io account"

## More
- Page: https://mcp.ai/seven_io
- Agent spec (llms.txt): https://mcp.ai/seven_io/llms.txt
- Postman collection: https://mcp.ai/seven_io/postman.json