# Seven.io — MCP server on 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.

By: mcp.ai · official
Page: https://mcp.ai/seven_io

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_seven_io?ms=1787293560000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/seven_io/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/seven_io/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/seven_io/skill.md
Postman collection (v2.1): https://mcp.ai/seven_io/postman.json

## Tools
- seven_io_create_contact(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) — Create a Seven.io contact with identity, address, phone, notes, and group fields.
- seven_io_delete_contact(contact_id: integer) — Permanently delete one Seven.io contact by ID. This is destructive and cannot be undone.
- seven_io_format_phone_numbers(numbers: string[]) — Validate and normalize one or more phone numbers without performing a paid carrier lookup.
- seven_io_get_analytics(end?: string, label?: string, start?: string, group_by?: string, subaccounts?: string) — Return Seven.io usage statistics for a date range, optionally grouped by date, label, subaccount, or country.
- seven_io_get_balance() — Return the connected Seven.io account's available credit balance and currency.
- seven_io_get_sms_pricing(country?: string) — Return Seven.io SMS prices, preferably narrowed to one destination country.
- seven_io_list_contacts(limit?: integer, offset?: integer, search?: string, group_id?: integer, order_by?: string, order_direction?: string) — List or search Seven.io contacts, optionally restricted to a contact group.
- seven_io_list_groups(limit?: integer, offset?: integer) — List Seven.io contact groups and their member counts for use in contact filtering or assignment.
- seven_io_query_message_journal(to?: string, limit?: integer, state?: string, offset?: integer, date_to?: string, date_from?: string, message_id?: integer, journal_type: string) — Query one page of outbound SMS, inbound SMS, or voice journal entries using a consistent filter interface.
- seven_io_send_sms(to: string[], ttl?: integer, from?: string, text: string, delay?: string, flash?: boolean, label?: string, foreign_id?: string, get_replies?: boolean, performance_tracking?: boolean) — 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.
- seven_io_update_contact(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) — Update selected standard fields or group memberships on an existing Seven.io contact.

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

## Links
Docs: https://mcp.ai/docs/mcps/seven_io
Website: https://mcp.ai/mcps/seven_io