# 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.

## Compatibility

Sumble MCP requires a custom MCP connection at the moment. It is possible in these LLMs

| Platform | Base Availability | Enterprise Requirements                           |
| -------- | ----------------- | ------------------------------------------------- |
| Claude   | Paid plans only   | Requires the ability to create a custom connector |
| Cursor   | All plans         | None (Available on all)                           |
| ChatGPT  | Paid plans only   | Requires dev-mode access                          |
| Gemini   | Not available     | N/A                                               |

## Claude instructions

{% hint style="info" %}
*Works on Claude Pro and above plans. Enterprise users need to contact their admin to enable adding custom connectors.*
{% 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

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

## 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 need to contact their admin to enable creating custom apps*
{% 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                    |
| -------------------- | -------------------------------------------------------- | ------------------------------ |
| `FindOrganizations`  | Search companies by technology, industry, size, location | 5 credits per result           |
| `EnrichOrganization` | Get technology adoption details for a specific company   | 5 credits per technology found |
| `MatchOrganizations` | Match company names/URLs to Sumble organization IDs      | 1 credit per matched org       |

### Organization Lists

| Tool                     | Description                                                    | Credit cost               |
| ------------------------ | -------------------------------------------------------------- | ------------------------- |
| `ListOrganizationLists`  | List saved organization lists with IDs and organization counts | 1 credit per list         |
| `GetOrganizationList`    | Get one organization list and the organizations in it          | 1 credit per organization |
| `CreateOrganizationList` | Create a new empty organization list                           | Free                      |
| `AddOrganizationsToList` | Add organizations to an existing list by ID or slug            | Free                      |

### Jobs

| Tool                     | Description                                                    | Credit cost         |
| ------------------------ | -------------------------------------------------------------- | ------------------- |
| `FindJobs`               | Search job postings by company, technology, role, location     | 2 credits per job   |
| `GetJobDescription`      | Get a job's title and full description by ID                   | 1 credit per job    |
| `FindRelatedPeopleToJob` | Find hiring managers and team members related to a job listing | 1 credit per person |

### People

| Tool                        | Description                                                          | Credit cost                                        |
| --------------------------- | -------------------------------------------------------------------- | -------------------------------------------------- |
| `FindPeople`                | Find people at a company by function, level, location                | 1 credit per person                                |
| `EnrichPerson`              | Get contact information (email) for a person                         | 10 credits if found, free if cached or unavailable |
| `FindRelatedPeopleToPerson` | Find people related to a specific person (same org, shared features) | 1 credit per person                                |

### 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 |

### Database

| Tool         | Description                                             | Credit cost                        |
| ------------ | ------------------------------------------------------- | ---------------------------------- |
| `Query`      | 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        |
| `LogOut`                | Log out the current user                                           | Free        |

## Credits

MCP calls consume credits from your Sumble account, just like the [REST API](https://docs.sumble.com/api). The structured tools (find, enrich) follow the same pricing as the corresponding API endpoints. SQL queries via the `Query` 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](https://docs.sumble.com/web-application/credits-and-exports) for details on monthly allocations and purchasing.