> 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, ChatGpt, or Gemini CLI. 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="" %} ## Compatibility On Claude and ChatGPT you can install Sumble directly from the app directory. Cursor, Claude Code, and Gemini CLI 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 — see [Claude setup](/api/mcp/mcp-claude.md) | Admin must enable connectors (Team/Enterprise) | | Cursor | All plans | Custom MCP connection — see [Cursor setup](/api/mcp/mcp-cursor.md) | None (Available on all) | | ChatGPT | Paid plans only | [ChatGPT directory](https://chatgpt.com/apps/sumble/asdk_app_69d6aed609708191a384fb6b59438690) or custom app — see [ChatGPT setup](/api/mcp/mcp-chatgpt.md) | None (Available on all) | | Gemini | Gemini CLI, Gemini Enterprise (beta) | Custom MCP connection — see [Gemini CLI setup](/api/mcp/mcp-gemini-cli.md) or [Gemini Enterprise setup](/api/mcp/mcp-gemini-enterprise.md) | Gemini Enterprise: beta, enabled per account on request | {% hint style="info" %} *Gemini support means the **Gemini CLI**, plus **Gemini Enterprise** in beta — the consumer Gemini web app and mobile apps do not support MCP connectors.* {% endhint %} ## Setup instructions Pick your platform for step-by-step setup: * [Claude](/api/mcp/mcp-claude.md) * [Cursor](/api/mcp/mcp-cursor.md) * [Claude Code](/api/mcp/mcp-claude-code.md) * [ChatGPT](/api/mcp/mcp-chatgpt.md) * [Gemini CLI](/api/mcp/mcp-gemini-cli.md) * [Gemini Enterprise](/api/mcp/mcp-gemini-enterprise.md) — beta, enabled per account on request ## 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). Search results exclude permanently closed organizations unless `include_closed` is set; match mode always resolves closed organizations | 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 | | `GetOrganizationSignals` | Get recent sales signals (notable changes) for one organization by ID: new hires on tracked technologies, leadership moves, and hiring or technology adoption trends. Optional technology-slug filter; each signal includes a deep-link `sumble_url` and, where relevant, a `person_id` or `job_post_id` for follow-up research | 1 credit per signal returned | | `GetOrganizationTechStack` | Get an organization's CONFIRMED-USED technology stack, grouped by business function and technology category — restricted to technologies Sumble has confirmed are actually in use, not merely mentioned | 1 credit per technology returned | ### 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 its organizations. Pass a CSV `file_name` to keep the list metadata and return file shape, size, and an authenticated Sumble download URL while omitting organization rows | 1 credit per organization | | `CreateOrganizationList` | Create a new empty organization list | Free | | `RenameOrganizationList` | Rename an existing organization list, keeping its ID, URL, and organizations | 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, saved organization lists, or signal config IDs. Supports `limit`/`offset` pagination. Returns only signals from the last 60 days (except direct `signal_ids` lookups); each signal carries the rule name and, when the config is readable, its ID | 1 credit per signal returned | | `SearchPrioritySignals` | Search Priority Signals digest items by source signal IDs, organization IDs, person IDs, job post IDs, or your relevance feedback (`is_relevant`); supports `limit`/`offset` pagination; each result includes its `id` and `is_relevant` | 1 credit per priority signal returned | | `UpdatePrioritySignalRelevance` | Mark a priority signal (by its `id` from `SearchPrioritySignals`) relevant or not relevant, or clear the feedback | Free | | `ListSignalConfigs` | List the active standing rules that decide which signals you receive — name, type, priority, scope, lookback window, filter definition, recent count, and settings link. Filter active configs by type or priority, or look up config IDs (including authorized deleted configs) as a separate mode. Read-only | Free | ### 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. Long-running requests (e.g. contact reveals) may return `status: "running"` with a `request_id`; call the tool again with only that `request_id` to retrieve the result. Credits are charged when the completed result is first returned. | 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; resolving an input email to a person costs 20 credits per resolved email (emails that don't resolve are free) | ### 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 its people. Pass a CSV `file_name` to keep the list metadata and return file shape, size, and an authenticated Sumble download URL. The CSV contains the person rows, which are omitted from the MCP response | 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 | ### Documentation These serve the pages of this documentation site, so your assistant can answer questions about how Sumble works from the same source you are reading now, rather than from a web search. | Tool | Description | Credit cost | | ---------------------- | --------------------------------------------------------------------------------- | ----------- | | `ListDocumentation` | List every documentation page, with its title and where it sits in the navigation | Free | | `GetDocumentationPage` | Read one documentation page, by the path `ListDocumentation` returned | 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.