> For the complete documentation index, see [llms.txt](https://docs.sumble.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sumble.com/api/mcp.md).

# MCP

With Sumble MCP, you can ask questions in natural language and get back structured data about organizations, technologies, job postings, and people - directly inside tools like Claude Desktop, Cursor, or ChatGpt. Behind the scenes, your AI assistant calls Sumble's API on your behalf.

## Getting started

Sumble is now listed in the [Claude](https://claude.ai/directory/connectors/sumble) and [ChatGPT](https://chatgpt.com/apps/sumble/asdk_app_69d6aed609708191a384fb6b59438690) app directories, so you can install it with one click on those platforms.

See this video to see how to find it in Claude

{% embed url="<https://youtu.be/-_kVxcGeACs?si=3knMpBfHlN2IASOP>" %}

## Compatibility

On Claude and ChatGPT you can install Sumble directly from the app directory. Cursor and Claude Code use a custom MCP connection. It is possible in these LLMs

| Platform | Base Availability | How to install                                                                                               | Enterprise Requirements                        |
| -------- | ----------------- | ------------------------------------------------------------------------------------------------------------ | ---------------------------------------------- |
| Claude   | Paid plans only   | [Claude directory](https://claude.ai/directory/connectors/sumble) or custom connector                        | Admin must enable connectors (Team/Enterprise) |
| Cursor   | All plans         | Custom MCP connection                                                                                        | None (Available on all)                        |
| ChatGPT  | Paid plans only   | [ChatGPT directory](https://chatgpt.com/apps/sumble/asdk_app_69d6aed609708191a384fb6b59438690) or custom app | None (Available on all)                        |
| Gemini   | Not available     | N/A                                                                                                          | N/A                                            |

## Claude instructions

{% hint style="info" %}
*Works on Claude Pro and above plans. Enterprise users may need to contact their admin to enable adding connectors.*
{% endhint %}

### Install from the Claude directory (recommended)

1. Open the Sumble connector in the [Claude directory](https://claude.ai/directory/connectors/sumble)
2. Click **Connect** (or **Add**)
3. Complete the auth flow
4. Use Sumble MCP in Claude chat

(Optional but suggested) Enable 'Allow access' to all endpoints. This prevents interruptions when an endpoint is used for the first time.

### Manual setup (custom connector)

{% hint style="info" %}
*Use this if your organization restricts the directory, or you prefer to add the connector manually.*
{% endhint %}

Video instructions [here](https://www.loom.com/share/8e4cc03e723f46ada0f40d56ecd80c96)

1. Go to Claude web app or desktop app (if desktop app - navigate to chat on the top)
2. Go to preferences (or `cmd + ,`) > Connectors -> Add a custom connector
3. Enter
   1. Name: `Sumble`
   2. Remote URL: [`https://mcp.sumble.com`](https://mcp.sumble.com/)
4. Complete the auth flow
5. Use Sumble MCP in Claude chat

## Cursor instructions

{% hint style="info" %}
*Works on all Cursor plans*
{% endhint %}

1. Go to Cursor settings (`Shift + CMD + J` on mac)
2. Navigate to 'Tools & MCP'
3. Click on New MCP Server (Add a Custom MCP Server)
4. Paste the JSON below

```
{
  "mcpServers": {
    "sumblemcp": { "type": "http", "url": "https://mcp.sumble.com" }
  }
}
```

5. Go back to Settings > 'Tools & MCP' > Click 'Connect'
6. Complete the auth flow
7. Use Sumble MCP in your Cursor chat

## Claude Code instructions

{% hint style="info" %}
*Works on all plans of Claude Code*
{% endhint %}

1. Run the following command in your terminal to install the MCP `claude mcp add --transport http sumble https://mcp.sumble.com --scope user`
2. Start Claude by running the `claude` command
3. Go to `/mcp` and find the sumble mcp and click enter
4. Complete auth and the MCP will be successfully setup

## ChatGPT instructions

{% hint style="info" %}
*Works on ChatGPT Pro and above plans. Enterprise users may need to contact their admin to enable using apps*
{% endhint %}

### Install from the ChatGPT app directory (recommended)

1. Open the Sumble app in the [ChatGPT directory](https://chatgpt.com/apps/sumble/asdk_app_69d6aed609708191a384fb6b59438690)
2. Click **Connect** (or **Add**)
3. Complete the auth flow
4. Use Sumble MCP in your ChatGPT chat

### Manual setup (custom app)

{% hint style="info" %}
*Use this if your organization restricts the directory, or you prefer to create the app manually.*
{% endhint %}

[Video](https://www.loom.com/share/ee27e8e24d574e6fb0851d28e6564c17) instructions on how to add Sumble MCP.

1. Go to ChatGPT settings (`cmd + ,` on mac)
2. Navigate to 'Apps'
3. Click on 'Create App'
   1. Enter
      1. Name: `Sumble`
      2. MCP Server URL: `https://mcp.sumble.com`
   2. Accept conditions and continue
4. Complete the auth flow
5. Use Sumble MCP in your ChatGPT chat

## Try it

Here are a few prompts to get you started:

> * Find all people who could be in the buying committee for Maintain at top facility\
>   management companies in CA
> * Which WHOOP job posts mention Hex? What teams use it? Who makes buying\
>   decisions around BI tools at Whoop?
> * Boston tech companies growing 20% YoY using Databricks and Looker, that have\
>   a data engineering team of less than 4?

## Available tools

### Organizations

| Tool                              | Description                                                                                                                                                                                            | Credit cost                                                               |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------- |
| `FindMatchAndEnrichOrganizations` | Find, match, and enrich organizations in one call — search by advanced query or resolve a list of names/URLs/IDs; returns selected attributes and per-entity metrics (technology, jobs, teams, people) | 1 credit per matched org + 1 per paid attribute + per-entity metric costs |
| `GetIntelligenceBrief`            | LLM-generated sales intelligence brief for a target account, synthesized by Google Gemini from Sumble's structured data                                                                                | 50 credits per completed brief                                            |

### Organization Lists

| Tool                         | Description                                                                                                                                          | Credit cost               |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
| `ListOrganizationLists`      | List saved organization lists with IDs, web app URLs, organization counts, read-only/deletable flags, deleted status, and Signals inclusion settings | 1 credit per list         |
| `GetOrganizationList`        | Get one organization list and the organizations in it, including each organization's Sumble profile URL and own website URL                          | 1 credit per organization |
| `CreateOrganizationList`     | Create a new empty organization list                                                                                                                 | Free                      |
| `AddOrganizationsToList`     | Add organizations to an existing list by ID or slug                                                                                                  | Free                      |
| `SetOrganizationListDeleted` | Soft-delete an organization list, or restore a deleted one                                                                                           | Free                      |
| `SetOrganizationListSignals` | Include or exclude a list's accounts from future Signals delivery                                                                                    | Free                      |

### Signals

| Tool                    | Description                                                                                                                                                       | Credit cost                           |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- |
| `SearchSignals`         | Search Sumble Signals across available accounts by signal IDs, organization IDs, person IDs, technologies, job functions, priorities, or saved organization lists | 1 credit per signal returned          |
| `SearchPrioritySignals` | Search Priority Signals digest items by source signal IDs, organization IDs, person IDs, or job post IDs                                                          | 1 credit per priority signal returned |

### Jobs

| Tool                     | Description                                                                                                                                                                                                                                                                                                                                                               | Credit cost                                                             |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| `FindMatchAndEnrichJobs` | Find, look up, and enrich job postings in one call — search by advanced query (with optional organization scoping) or enrich a list of job IDs; returns selected attributes (title, full description, location, posted date, organization, extracted technologies, teams, job functions, levels, projects) and optional related people (hiring managers and team members) | 1 credit per job + 1 per paid attribute + 1 per related person returned |
| `LookupJobTitles`        | Resolve a list of job titles to their canonical job function and level                                                                                                                                                                                                                                                                                                    | 1 credit per 100 matched titles                                         |

### People

| Tool                       | Description                                                                                                                                                                                                                                                                        | Credit cost                                                                                                                                                                                                      |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `FindMatchAndEnrichPeople` | Find, match, and enrich people in one call — resolve person IDs, LinkedIn URLs, or emails, or search within organizations by advanced query; returns selected attributes, optional related people (inferred managers and direct reports), and optional email/phone contact reveals | 1 credit per person + 1 per paid attribute + 1 per related person; 10 credits per first email reveal, 80 credits per first phone reveal — free on repeat reveals of the same type, or if the type is unavailable |

### Contact Lists

| Tool                | Description                                                  | Credit cost         |
| ------------------- | ------------------------------------------------------------ | ------------------- |
| `ListContactLists`  | List saved contact (people) lists with IDs and people counts | 1 credit per list   |
| `GetContactList`    | Get one contact list and the people in it                    | 1 credit per person |
| `CreateContactList` | Create a new empty contact list                              | Free                |
| `AddContactsToList` | Add people to an existing contact list by person ID          | Free                |

### Technologies

| Tool                         | Description                                                                                                     | Credit cost                           |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------- | ------------------------------------- |
| `SearchTechnologies`         | Look up technology names and slugs                                                                              | 1 credit per search                   |
| `LookupTechnologies`         | Resolve a list of technology names, slugs, or aliases to canonical IDs, slugs, names, and categories            | 1 credit per 100 matched technologies |
| `LookupTechnologyCategories` | Resolve a list of technology category slugs or names to their canonical categories and constituent technologies | 1 credit per 100 matched categories   |

### Projects

| Tool             | Description                                                                 | Credit cost                       |
| ---------------- | --------------------------------------------------------------------------- | --------------------------------- |
| `LookupProjects` | Resolve a list of project names or slugs to canonical IDs, slugs, and names | 1 credit per 100 matched projects |

### Support

| Tool                     | Description                                                                                                                                                                                      | Credit cost |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------- |
| `ReportDataQualityIssue` | Report a data quality or coverage issue — incorrect/missing/stale data, or a missing category, field, filter, project/signal type, taxonomy value, or data limit; routed to the Sumble data team | Free        |
| `SubmitSupportRequest`   | Submit a general account, billing, or access support request (not data or coverage); routed to the Sumble support team                                                                           | Free        |

### Database

| Tool          | Description                                             | Credit cost                        |
| ------------- | ------------------------------------------------------- | ---------------------------------- |
| `RunSqlQuery` | Run read-only SQL against Sumble's DuckDB (last resort) | 1 credit per 100 bytes of response |
| `ListTables`  | List all tables and columns in the database             | Free                               |

### Account

| Tool                    | Description                                                        | Credit cost |
| ----------------------- | ------------------------------------------------------------------ | ----------- |
| `GetAccountInformation` | Check your credit balance, API key status, and plan info           | Free        |
| `GetMyCompanyProfile`   | Get your company's profile and target account intelligence profile | Free        |

## Credits

MCP calls consume credits from your Sumble account, just like the [REST API](/api/api.md). The structured tools (find, enrich) follow the same pricing as the corresponding API endpoints. SQL queries via the `RunSqlQuery` tool are priced at 1 credit per 100 bytes of response data.

You can check your balance at any time by asking your assistant, or visit [sumble.com/account](https://sumble.com/account). To purchase additional credits, go to [Account > Purchase](https://sumble.com/account/purchase).

See [Credits](/web-app/exports-credits/credits-and-exports.md) for details on monthly allocations and purchasing.