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 and ChatGPT app directories, so you can install it with one click on those platforms.
See this video to see how to find it in Claude
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
Claude
Paid plans only
Claude directory or custom connector — see Claude setup
Admin must enable connectors (Team/Enterprise)
Gemini
Gemini CLI, Gemini Enterprise (beta)
Custom MCP connection — see Gemini CLI setup or Gemini Enterprise setup
Gemini Enterprise: beta, enabled per account on request
Setup instructions
Pick your platform for step-by-step setup:
Gemini Enterprise — 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
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; confirmation required above 500 credits
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, plus person_sumble_url (the person's Sumble profile, the primary link) and linkedin_url
1 credit per signal returned; confirmation required above 500 credits
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; confirmation required above 500 credits
Organization Lists
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; confirmation required above 500 credits
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
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. A signal about a person also carries person_sumble_url (their Sumble profile, the primary link) and linkedin_url; job-post signals carry suggested_contacts.people, each with sumble_url and linkedin_url
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
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; confirmation required above 500 credits
LookupJobTitles
Resolve a list of job titles to their canonical job function and level. Pass a CSV file_name to return the classifications in a downloadable file instead of including the rows in the MCP response
1 credit per 100 matched titles
People
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 (including the person's full experience history and profile summary in match mode), 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); confirmation required above 500 credits
Contact Lists
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; confirmation required above 500 credits
CreateContactList
Create a new empty contact list
Free
AddContactsToList
Add people to an existing contact list by person ID
Free
Technologies
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
LookupProjects
Resolve a list of project names or slugs to canonical IDs, slugs, and names
1 credit per 100 matched projects
Support
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
RunSqlQuery
Run read-only SQL against Sumble's DuckDB (last resort). A query that matches more than 1,000 rows fails: no rows are returned and nothing is charged
1 credit per 100 bytes of response; confirmation required above 500 credits
ListTables
List all tables and columns in the database
Free
Account
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.
SearchDocumentation
Search the documentation and return matching page paths, titles, URLs, and excerpts
Free
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. 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, so you pay only for the rows you get back. A query that matches more than 1,000 rows fails without returning rows or charging credits: add a LIMIT of 1,000 or less, aggregate in SQL, or narrow the WHERE clause.
An MCP request that would cost more than 500 credits is refused. Nothing is charged and no data is returned. To go ahead, your assistant passes allow_expensive_query, which it should do only after asking you. Assistants that cannot pass the parameter have to narrow the request instead. The REST API is not affected.
You can check your balance at any time by asking your assistant, or visit sumble.com/account. To purchase additional credits, go to Account > Purchase.
See Credits for details on monthly allocations and purchasing.
Last updated