# Specific — how to use (mcp.ai)

Connect your Specific account and use 18 tools for AI sales tools straight from your AI agent. Connect with your own API key. Sales call analytics to drive revenue.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/specific/create/company` — Tool to create a new company record in the Specific platform. Use when you need to add a new company to the workspace with optional ID, name, and custom attributes.
  - body: { id?: string, name?: string, attributes?: object }
- `POST https://api.mcp.ai/api/specific/create/conversation` — Tool to create a new conversation (survey response) in the Specific platform. Use when you need to add a new conversation with content, optional contacts, companies, and custom fields. Content can be 
  - body: { source?: object, company?: object, contact?: object, content: string|object, sourceUrl?: string, insertedAt?: string, customFields?: object }
- `POST https://api.mcp.ai/api/specific/create/or/update/company` — Tool to upsert a company record in the Specific platform (create if not exists, update if exists). Use when you need to ensure a company exists with specific data, creating or updating as necessary ba
  - body: { data: object, where: object }
- `POST https://api.mcp.ai/api/specific/create/or/update/user` — Tool to upsert a user record in the Specific platform (creates if not exists, updates if exists). Use when you need to ensure a contact exists with specific data, merging with existing records based o
  - body: { data: object, where: object }
- `POST https://api.mcp.ai/api/specific/create/user` — Tool to create a new user (contact) record in the Specific platform. Use when you need to add a new contact with email, name, and optional custom attributes or company association.
  - body: { id?: string, name?: string, email?: string, company?: object, attributes?: object }
- `POST https://api.mcp.ai/api/specific/delete/company` — Tool to delete a company record from the Specific platform. Use when you need to remove a company by its ID. The operation is permanent and returns the deleted company's details.
  - body: { id: string }
- `POST https://api.mcp.ai/api/specific/delete/company/attributes` — Tool to delete specific custom field attributes from a company record. Use when you need to remove custom attributes by their keys from a company. Returns the updated company details.
  - body: { keys: string[], company_id: string }
- `POST https://api.mcp.ai/api/specific/delete/user` — Tool to remove a user record from the Specific platform. Use when you need to permanently delete a contact from the workspace.
  - body: { email?: string, user_id?: string }
- `POST https://api.mcp.ai/api/specific/delete/user/attributes` — Tool to delete specific custom field attributes from a user record in the Specific platform. Use when you need to remove custom field values from a contact without deleting the contact itself.
  - body: { data: object, where: object }
- `POST https://api.mcp.ai/api/specific/get/my/workspace` — Tool to get current workspace information for the authenticated user. Use when you need to retrieve the workspace ID and name for the authenticated API key.
- `POST https://api.mcp.ai/api/specific/list/companies` — Tool to query company records from the Specific platform via GraphQL. Use when you need to retrieve company information, optionally filtering by ID or name.
  - body: { where?: object }
- `POST https://api.mcp.ai/api/specific/list/conversations` — Tool to query conversation records (survey responses) from the Specific platform via GraphQL. Use when you need to retrieve customer feedback, survey responses, or conversation history. Returns up to 
  - body: { where?: object }
- `POST https://api.mcp.ai/api/specific/list/custom/fields` — Tool to query custom field definitions in the Specific platform. Use when you need to retrieve available custom fields that can be associated with companies, contacts, or conversations. Optionally fil
  - body: { field_type?: string }
- `POST https://api.mcp.ai/api/specific/list/sources` — Tool to retrieve all data sources from the Specific platform. Use when you need to fetch available sources in the workspace.
- `POST https://api.mcp.ai/api/specific/list/surveys` — Tool to retrieve multiple survey records from the Specific platform via GraphQL. Use when you need to fetch all available surveys with their metadata, including names, contexts, tones, and associated 
- `POST https://api.mcp.ai/api/specific/list/users` — Tool to query user accounts from the Specific platform via GraphQL. Use when you need to retrieve user information, optionally filtering by ID, email, or custom attributes.
  - body: { where?: object }
- `POST https://api.mcp.ai/api/specific/update/company` — Tool to update an existing company record in the Specific platform. Use when modifying company name or custom attributes.
  - body: { id: string, name?: string, attributes?: object }
- `POST https://api.mcp.ai/api/specific/update/user` — Tool to modify an existing user record in the Specific platform via GraphQL mutation. Use when you need to update contact information such as name, email, company association, or custom attributes.
  - body: { data: object, where: object }

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

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