# Godial — how to use (mcp.ai)

Connect your Godial account and use 24 tools for CRM straight from your AI agent. Connect with your own API key. GoDial is an automatic call app, mobile CRM, and outbound dialer software that transforms your phone into a call center, enabling efficient management of calls and contacts.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_godial?ms=1787291280000`
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. `godial_add_contact`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/godial`
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/godial/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/godial/add/contact` — Add a new contact to a GoDial CRM list. Requires a valid list ID (obtain from List External Lists action) and phone number. Returns the created contact with assigned ID, timestamps, and lead score.
  - body: { name?: string, note?: string, email?: string, extra?: string, phone: string, listId: string, remarks?: string, companyName?: string, secondPhone?: string, assignmentMode?: string }
- `POST https://api.mcp.ai/api/godial/add/list` — Tool to create a new contact list in GoDial. Use when you need to add a list for organizing contacts within a team. Requires a valid team ID (obtain from List Accounts action).
  - body: { name: string, teamsId: string }
- `POST https://api.mcp.ai/api/godial/add/task` — Add a new task to GoDial. Use when you need to create a task and assign it to a specific account. Requires account ID which can be obtained from List Accounts action.
  - body: { name: string, accountsId: string, description?: string }
- `POST https://api.mcp.ai/api/godial/add/team` — Tool to add a new team to your GoDial company. Use when you need to create a team for organizing accounts or users within your organization.
  - body: { name: string }
- `POST https://api.mcp.ai/api/godial/delete/contact/by/phone` — Tool to delete a contact from a GoDial list by phone number. Use when you need to remove a specific contact identified by their phone number from a particular list.
  - body: { phone: string, listId: string }
- `POST https://api.mcp.ai/api/godial/dispose/contact` — Tool to insert disposition details for a contact (e.g., call outcome). Use after completing a call to record the result. Requires valid disposition status configured in the system.
  - body: { id: string, type: string, dispo: string, calledOn: string, callerId: string }
- `POST https://api.mcp.ai/api/godial/list/accounts` — Tool to retrieve all accounts in the authenticated GoDial account. Use after obtaining access token to fetch available accounts. Supports optional pagination.
  - body: { page?: integer, perPage?: integer }
- `POST https://api.mcp.ai/api/godial/list/contacts` — Tool to retrieve all contacts from a specific GoDial list. Use when you need to view or enumerate contacts within a list by providing the list ID.
  - body: { page?: integer, listId: string, perPage?: integer }
- `POST https://api.mcp.ai/api/godial/list/external/lists` — Tool to retrieve all lists in the authenticated GoDial account. Use when you need to enumerate lists for selecting a target list ID after configuring your External API access token.
- `POST https://api.mcp.ai/api/godial/list/tasks` — Tool to retrieve all tasks in the authenticated GoDial account. Use when you need to enumerate tasks for viewing, filtering, or managing task workflows.
  - body: { page?: integer, perPage?: integer }
- `POST https://api.mcp.ai/api/godial/list/teams` — Tool to retrieve all teams in the authenticated GoDial company. Use when you need to enumerate teams for your company after configuring your External API access token.
- `POST https://api.mcp.ai/api/godial/remove/account` — Tool to remove a GoDial account. Use when an account needs to be permanently deleted.
  - body: { id: string }
- `POST https://api.mcp.ai/api/godial/remove/account2` — Tool to remove an account from your GoDial company. Use when you need to delete a specific account by its ID. Returns the count of accounts removed.
  - body: { id: string }
- `POST https://api.mcp.ai/api/godial/remove/contact` — Tool to remove a contact from GoDial by ID. Use when a contact needs to be deleted from a list. Returns the count of contacts removed.
  - body: { id: string }
- `POST https://api.mcp.ai/api/godial/remove/list` — Tool to remove a contact list from GoDial. Use when you need to delete a specific list by its ID.
  - body: { id: string }
- `POST https://api.mcp.ai/api/godial/remove/task` — Tool to remove a particular task from GoDial. Use when a task needs to be deleted. Returns the count of tasks removed.
  - body: { id: string }
- `POST https://api.mcp.ai/api/godial/remove/team` — Tool to remove a team from your GoDial company. Use when you need to permanently delete a team from your organization.
  - body: { id: string }
- `POST https://api.mcp.ai/api/godial/update/contact` — Update an existing contact in GoDial CRM. Requires contact ID and at least one field to update. Returns the updated contact with all current field values.
  - body: { id: string, name?: string, note?: string, email?: string, extra?: string, phone?: string, remarks?: string, companyName?: string, secondPhone?: string }
- `POST https://api.mcp.ai/api/godial/update/list` — Tool to update an existing contact list in GoDial. Use when you need to modify list properties such as name, team assignment, call script, or Indiamart integration settings.
  - body: { id: string, name?: string, teamsId?: string, indiamart?: object, callScript?: string, twillioAudioUrl?: string }
- `POST https://api.mcp.ai/api/godial/update/team` — Update an existing team in GoDial. Requires a valid team ID and the new team name. Returns the updated team details with timestamps.
  - body: { id: string, name?: string }
- `POST https://api.mcp.ai/api/godial/view/contact` — Tool to view details of a specific contact by ID. Use when you need to retrieve complete information about a contact including phone, email, company details, and lead tracking data.
  - body: { id: string }
- `POST https://api.mcp.ai/api/godial/view/list` — Tool to view details of a specific contact list by ID. Use when you need to retrieve detailed information about a list including its name, associated company/team, and configuration.
  - body: { id: string }
- `POST https://api.mcp.ai/api/godial/view/task` — Tool to view details of a specific task by ID. Use when you need to retrieve information about a task in GoDial. Returns task details including name, status, assigned account, and timestamps.
  - body: { id: string }
- `POST https://api.mcp.ai/api/godial/view/team` — Tool to view details of a specific team by ID. Use when you need to retrieve information about a particular team in the GoDial account.
  - body: { id: string }

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

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