# Sumble

```json
{
  "name": "Sumble",
  "slug": "sumble",
  "url": "https://composio.dev/toolkits/sumble",
  "markdown_url": "https://composio.dev/toolkits/sumble.md",
  "logo_url": "https://logos.composio.dev/api/sumble",
  "categories": [
    "sales & customer support"
  ],
  "is_composio_managed": false,
  "updated_at": "2026-11-18T05:42:09.083Z"
}
```

![Sumble logo](https://logos.composio.dev/api/sumble)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Sumble MCP or direct API to search companies, find people, enrich accounts, analyze technologies, and track business signals through natural language.

## Summary

Sumble is a go-to-market intelligence platform for company and people search, enrichment, and business signals.
It helps teams find better prospects and understand their markets with technology and buying insights.

## Categories

- sales & customer support

## Toolkit Details

- Tools: 34

## Images

- Logo: https://logos.composio.dev/api/sumble

## Authentication

- **Api Key**
  - Type: `api_key`
  - Description: Api Key authentication for Sumble.
  - Setup:
    - Configure Api Key credentials for Sumble.
    - Use the credentials when creating an auth config in Composio.

## Suggested Prompts

- Find SaaS companies using Salesforce today
- Enrich this prospect list with company data
- Identify companies showing recent buying signals

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `SUMBLE_ADD_ORGANIZATIONS_TO_LIST` | Add Organizations to List | Add companies to an organization list by Sumble IDs or slugs and return added IDs plus invalid inputs. Existing members are skipped. This free mutation changes persistent private targeting membership. |
| `SUMBLE_ADD_PEOPLE_TO_CONTACT_LIST` | Add People to Contact List | Add 1 to 10,000 Sumble person IDs to a saved contact list and report newly added versus already-present counts. This free persistent mutation stores sensitive people-list membership. Free and Pro lists are capped at 10,000 total members; an over-limit request fails atomically with contact_list_full. |
| `SUMBLE_CREATE_CONTACT_LIST` | Create Contact List | Create a persistent empty contact list and return its ID and Sumble URL. This free mutation creates private account state and does not reveal contact PII. |
| `SUMBLE_CREATE_DATA_QUALITY_REPORT` | Create Data Quality Report | Email Sumble's data team immediately about incorrect, missing, or stale data. This free, irreversible, sensitive external communication sends user-provided issue text, a URL, and a page title outside Composio and uses the connected account email as reply-to. |
| `SUMBLE_CREATE_ORGANIZATION_LIST` | Create Organization List | Create a persistent empty organization list and return its ID and Sumble URL. This free mutation creates private account state. |
| `SUMBLE_CREATE_SUPPORT_REQUEST` | Create Support Request | Send an account, billing, or product request to Sumble support by external email immediately. This free, irreversible, sensitive communication sends user-provided text and a URL outside Composio and uses the connected account email as reply-to. |
| `SUMBLE_FIND_LOCATIONS` | Find Locations | Search Sumble location names, list a location's children, or list top-level locations and return exact case-sensitive filter codes. Region codes work only in organization filters; before using a region in a people filter, pass the region code as parent and use the returned country codes. This billable read costs one credit when at least one location is returned; requests with no matches cost no credits. |
| `SUMBLE_FIND_TECHNOLOGIES` | Find Technologies | Search Sumble's technology catalog by a partial name and return up to 50 canonical slugs for company, people, or signal filters. A request costs one credit only when at least one technology is returned. When file_name is set, the response contains file metadata instead of inline technologies; the download URL requires the file owner's authenticated Sumble session. |
| `SUMBLE_GET_COMPANY_SIGNALS` | Get Company Signals | Return recent Sumble signals for one company, optionally restricted to explicit canonical technology slugs. Signals can include suggested-contact profile data and connected-account CRM relationship status. This billable read consumes one credit per returned signal; no returned signals consume no credits. When file_name is set, the response contains file metadata instead of inline signals; the download URL requires the file owner's authenticated Sumble session. |
| `SUMBLE_GET_COMPANY_TECH_STACK` | Get Company Tech Stack | Return technologies Sumble confirms a company uses, grouped by business function and category. This billable read consumes one credit per primary technology returned; companies with no confirmed technologies consume no credits. When file_name is set, the response contains file metadata instead of inline business functions; the download URL requires the file owner's authenticated Sumble session. |
| `SUMBLE_GET_CONTACT_LIST` | Get Contact List | Get one private contact list and its enriched people, including available email and phone PII. This billable, sensitive read costs one credit per person. When file_name is set, authenticated-download metadata replaces inline people. |
| `SUMBLE_GET_CONVERSATION` | Get Conversation | Read one caller-owned Ask Sumble transcript page in saved message order, including private message text, attachment names, expiring generated-file links, and per-message accounting metadata. This free, highly sensitive read does not charge recorded credits again and never fetches additional transcript pages automatically. |
| `SUMBLE_GET_INTELLIGENCE_BRIEF` | Get Intelligence Brief | Retrieve or irreversibly start a Sumble AI intelligence brief for one organization. A completed brief costs 50 credits and can contain sensitive account strategy, contacts, teams, and technology intelligence. A pending response is free; this action returns it immediately and never polls. |
| `SUMBLE_GET_ORGANIZATION_LIST` | Get Organization List | Get one saved organization list and its companies, optionally including a deleted list or returning the rows as a file. This sensitive, billable read costs one credit per company returned and can expose private targeting and CRM data. |
| `SUMBLE_LIST_CONTACT_LISTS` | List Contact Lists | List saved people lists with IDs, private names, counts, and URLs. This billable, sensitive read costs one credit per returned list. When file_name is set, the response contains authenticated-download metadata and no inline rows. |
| `SUMBLE_LIST_CONVERSATIONS` | List Conversations | List the caller's private Ask Sumble conversations, newest updated first, with one-based page continuation. This free, sensitive read returns only caller-owned conversation metadata and never fetches additional pages automatically. |
| `SUMBLE_LIST_ORGANIZATION_LISTS` | List Organization Lists | List saved organization lists, optionally including soft-deleted lists. This billable read costs one credit per list returned and can expose private list names, counts, URLs, and settings. It can return a downloadable file. |
| `SUMBLE_LIST_SIGNAL_CONFIGS` | List Signal Configs | List visible standing signal rules or look up authorized historical config IDs. This free but sensitive read exposes account-, customer-, or domain-scoped monitoring rules and filters. It is unpaginated and can return file metadata. |
| `SUMBLE_LOOKUP_JOB_TITLES` | Lookup Job Titles | Classify 1 to 1000 raw job titles into Sumble job functions and levels for people or company filters. This billable read costs one credit per 100 titles matched to at least one classification; unmatched titles are free. When file_name is set, the response contains file metadata instead of inline results; the download URL requires the file owner's authenticated Sumble session. |
| `SUMBLE_LOOKUP_PROJECTS` | Lookup Projects | Resolve project names or slugs to canonical Sumble projects for company query filters. This billable read consumes one credit per 100 matched projects; unmatched inputs do not consume credits. When file_name is set, the response contains file metadata instead of inline results; the download URL requires the file owner's authenticated Sumble session. |
| `SUMBLE_LOOKUP_TECHNOLOGIES` | Lookup Technologies | Resolve known technology names, slugs, or aliases to canonical Sumble technologies in input order. This billable read costs one credit per 100 matched technologies; unmatched inputs consume no credits. When file_name is set, the response contains file metadata instead of inline results; the download URL requires the file owner's authenticated Sumble session. |
| `SUMBLE_LOOKUP_TECHNOLOGY_CATEGORIES` | Lookup Technology Categories | Resolve technology category names or slugs and enumerate their canonical technologies for Sumble company filters. This billable read costs one credit per 100 matched categories; unmatched inputs consume no credits. When file_name is set, the response contains file metadata instead of inline results; the download URL requires the file owner's authenticated Sumble session. |
| `SUMBLE_RENAME_ORGANIZATION_LIST` | Rename Organization List | Rename a user-owned organization list without changing its membership. This free persistent mutation cannot rename read-only group lists. |
| `SUMBLE_SEARCH_AND_ENRICH_COMPANIES` | Search and Enrich Companies | Match known companies or search Sumble companies and return only explicitly selected firmographic and entity metrics. This billable, sensitive read can expose CRM relationship data and consumes credits per returned company, paid attribute, and metric. |
| `SUMBLE_SEARCH_AND_ENRICH_JOBS` | Search and Enrich Jobs | Match job-post IDs or search Sumble job posts and return explicitly selected details, extracted entities, and related people. This billable, sensitive read costs one base credit per matched or returned job, plus one per paid attribute and related person; full descriptions and inferred relationships can contain sensitive business data. |
| `SUMBLE_SEARCH_AND_ENRICH_PEOPLE` | Search and Enrich People | Start or poll Sumble's asynchronous people match/search and return only explicitly selected attributes. This is a billable, PII-sensitive read: email reveal costs 10 credits, phone reveal 80 credits, and reverse lookup costs 20 credits per resolved input email. Contact fields are never inferred or added; poll by invoking this action again with request_id alone. When file_name is set, successful file creation replaces inline people with an authenticated-session download; file-write failure falls back to inline rows. |
| `SUMBLE_SEARCH_AND_ENRICH_TEAMS` | Search and Enrich Teams | Match team IDs or search teams within specified organizations and return selected team attributes, related people, and job posts. This billable, sensitive read costs one base credit per matched or returned team, plus one per paid attribute, related person, and job post, and exposes inferred organization and team relationships. |
| `SUMBLE_SEARCH_DOCUMENTATION` | Search Documentation | Search Sumble product documentation using a few words or a short question and return matching paths, titles, excerpts, and published URLs. This read is free. The query is sent to Sumble and may contain sensitive text. |
| `SUMBLE_SEARCH_PRIORITY_SIGNALS` | Search Priority Signals | Search Sumble priority-signal digest items by source entities and existing relevance or written feedback. This sensitive, billable read returns private feedback and AI-generated account intelligence and costs one credit per item. Results are one offset page ordered by completion time. |
| `SUMBLE_SEARCH_SIGNALS` | Search Signals | Search recent Sumble signals across visible accounts by organizations, people, technologies, priorities, lists, configs, or exact signal IDs. This sensitive, billable read can expose CRM status and suggested contacts and costs one credit per returned signal. Results are one deterministic newest-first offset page. |
| `SUMBLE_SET_ORGANIZATION_LIST_DELETED` | Delete or Restore Organization List | Soft-delete or restore an organization list while preserving its companies. This free persistent mutation is reversible. |
| `SUMBLE_SET_ORGANIZATION_LIST_SIGNALS` | Set Organization List Signals | Include or exclude an organization list's companies from future Signals delivery. This free mutation changes ongoing account behavior. |
| `SUMBLE_UPDATE_PRIORITY_SIGNAL_FEEDBACK` | Update Priority Signal Feedback | Replace or clear private written feedback on a priority signal. This free, sensitive persistent mutation affects future priority signals and Ask Sumble behavior. Empty text or null clears the prior value. |
| `SUMBLE_UPDATE_PRIORITY_SIGNAL_RELEVANCE` | Update Priority Signal Relevance | Mark a priority signal relevant or not relevant, or clear the relevance value. This free persistent mutation affects feedback used to generate future digests. |

## Supported Triggers

None listed.

## Installation and MCP Setup

### Path 1: SDK Installation

#### Path 1, Step 1: Install Composio

Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
```python
pip install composio composio_openai openai
```

```typescript
npm install @composio/core @composio/openai openai
```

#### Path 1, Step 2: Create a Composio session

Initialize Composio with the OpenAI Responses provider and create a session scoped to Sumble
```python
import json
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
client = OpenAI()

session = composio.create(user_id="your-user-id", toolkits=["sumble"])
tools = session.tools()
```

```typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["sumble"] });
const tools = await session.tools();
```

#### Path 1, Step 3: Run Sumble tools with your agent

Send a request, execute the Sumble tool calls through the session, and print the final answer
```python
response = client.responses.create(
    model="gpt-5.6-sol",
    tools=tools,
    input=[{"role": "user", "content": "Find 10 software companies in the United States that use Salesforce and show their latest business signals."}],
)

while True:
    tool_calls = [o for o in response.output if o.type == "function_call"]
    if not tool_calls:
        break
    results = composio.provider.handle_tool_calls(response=response, session=session)
    response = client.responses.create(
        model="gpt-5.6-sol",
        tools=tools,
        previous_response_id=response.id,
        input=[
            {"type": "function_call_output", "call_id": call.call_id, "output": json.dumps(results[i])}
            for i, call in enumerate(tool_calls)
        ],
    )

print(response.output_text)
```

```typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Find 10 software companies in the United States that use Salesforce and show their latest business signals." }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
```

### Path 2: MCP Server Setup

#### Path 2, Step 1: Install Composio

Install the Composio SDK and your agent framework
```python
pip install composio claude-agent-sdk
```

```typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
```

#### Path 2, Step 2: Create a session with MCP enabled

Create a session scoped to Sumble and read its MCP URL and headers
```python
from composio import Composio

composio = Composio()
session = composio.create(user_id="your-user-id", toolkits=["sumble"], mcp=True)
```

```typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["sumble"],
  mcp: true,
});
```

#### Path 2, Step 3: Connect your agent to the MCP server

Pass the session's MCP URL and headers to your agent and run a Sumble request
```python
import asyncio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions, AssistantMessage, TextBlock

options = ClaudeAgentOptions(
    mcp_servers={
        "composio": {
            "type": "http",
            "url": session.mcp.url,
            "headers": session.mcp.headers,
        }
    },
    system_prompt="You are a helpful assistant with access to Sumble tools.",
    tools=[],
    allowed_tools=["mcp__composio__*"],
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query("Find 10 software companies in the United States that use Salesforce and show their latest business signals.")
        async for message in client.receive_response():
            if isinstance(message, AssistantMessage):
                for block in message.content:
                    if isinstance(block, TextBlock):
                        print(block.text)

asyncio.run(main())
```

```typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Find 10 software companies in the United States that use Salesforce and show their latest business signals.",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
```

## Why Use Composio?

### 1. AI Native Sumble Integration

- Supports both Sumble MCP and direct API-based integrations
- Structured, LLM-friendly schemas for reliable company, people, and signal searches
- Rich coverage for finding prospects, enriching accounts, and analyzing market data

### 2. Secure API Key Handling

- Connect Sumble with your own API key credentials
- Keep API keys in Composio instead of hard-coding them in agent code
- Use scoped credentials across users, environments, and production workflows

### 3. Agent Optimized Design

- Tools are tuned using real error and success rates to improve reliability over time
- Comprehensive execution logs so you always know what ran, when, and on whose behalf

### 4. Enterprise Grade Security

- Fine-grained RBAC so you control which agents and users can access Sumble
- Scoped, least-privilege access to Sumble company, people, and signal data
- Full audit trail of agent actions to support review and compliance

## Use Sumble with any AI Agent Framework

Choose a framework you want to connect Sumble with:

- [ChatGPT](https://composio.dev/toolkits/sumble/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/sumble/framework/claude-cowork)
- [Hermes](https://composio.dev/toolkits/sumble/framework/hermes-agent)
- [Atomic Agent](https://composio.dev/toolkits/sumble/framework/atomic-agent)

## Related Toolkits

- [Aeroleads](https://composio.dev/toolkits/aeroleads) - Aeroleads is a B2B lead generation platform for finding business emails and phone numbers. Grow your sales pipeline faster with powerful prospecting tools.
- [Autobound](https://composio.dev/toolkits/autobound) - Autobound is an AI-powered sales engagement platform that crafts hyper-personalized outreach and insights. It helps sales teams boost response rates and close more deals through tailored content and recommendations.
- [Better proposals](https://composio.dev/toolkits/better_proposals) - Better Proposals is a web-based tool for crafting and sending professional proposals. It helps teams impress clients and close deals faster with slick, easy-to-use templates.
- [Bidsketch](https://composio.dev/toolkits/bidsketch) - Bidsketch is a proposal software that helps businesses create professional proposals quickly and efficiently. It streamlines the proposal process, saving time while boosting client win rates.
- [Bolna](https://composio.dev/toolkits/bolna) - Bolna is an AI platform for building conversational voice agents. It helps businesses automate support and streamline interactions through natural, voice-powered conversations.
- [Botdog](https://composio.dev/toolkits/botdog) - Botdog is a LinkedIn outreach platform for managing campaigns, leads, messages, analytics, and sending accounts. It helps sales teams run outbound workflows and track performance from one place.
- [BotPenguin](https://composio.dev/toolkits/botpenguin) - BotPenguin is an AI chatbot platform for customer messaging, contacts, and conversations. It helps teams manage bot-led support and lead engagement across channels.
- [Botsonic](https://composio.dev/toolkits/botsonic) - Botsonic is a no-code AI chatbot builder for easily creating and deploying chatbots to your website. It empowers businesses to offer conversational experiences without writing code.
- [Botstar](https://composio.dev/toolkits/botstar) - BotStar is a comprehensive chatbot platform for designing, developing, and training chatbots visually on Messenger and websites. It helps businesses automate conversations and customer interactions without coding.
- [Callerapi](https://composio.dev/toolkits/callerapi) - CallerAPI is a white-label caller identification platform for branded caller ID and fraud prevention. It helps businesses boost customer trust while stopping spam, fraud, and robocalls.
- [Callingly](https://composio.dev/toolkits/callingly) - Callingly is a lead response management platform that automates immediate call and text follow-ups with new leads. It helps sales teams boost response speed and close more deals by connecting seamlessly with CRMs and lead sources.
- [Callpage](https://composio.dev/toolkits/callpage) - Callpage is a lead capture platform that lets businesses instantly connect with website visitors via callback. It boosts lead generation and increases your sales conversion rates.
- [Charla](https://composio.dev/toolkits/charla) - Charla is a live chat and AI customer-support platform for property teams. It helps manage guest conversations, property contacts, and support knowledge.
- [Chatforma](https://composio.dev/toolkits/chatforma) - Chatforma is a chatbot automation platform for building and managing bots. It helps teams run dialogs, segments, broadcasts, forms, and user updates from one place.
- [Clearout](https://composio.dev/toolkits/clearout) - Clearout is an AI-powered service for verifying, finding, and enriching email addresses. It boosts deliverability and helps you discover high-quality leads effortlessly.
- [Clientary](https://composio.dev/toolkits/clientary) - Clientary is a platform for managing clients, invoices, projects, proposals, and more. It streamlines client work and saves you serious admin time.
- [Convolo ai](https://composio.dev/toolkits/convolo_ai) - Convolo ai is an AI-powered communications platform for sales teams. It accelerates lead response and improves conversion rates by automating calls and integrating workflows.
- [Crisp](https://composio.dev/toolkits/crisp) - Crisp is a customer messaging platform for live chat, contacts, helpdesk, and campaigns. It helps support teams manage customer conversations from one shared workspace.
- [Delighted](https://composio.dev/toolkits/delighted) - Delighted is a customer feedback platform based on the Net Promoter System®. It helps you quickly gather, track, and act on customer sentiment.
- [Docsbot ai](https://composio.dev/toolkits/docsbot_ai) - Docsbot ai is a platform that lets you build custom AI chatbots trained on your documentation. It automates customer support and content generation, saving time and improving response quality.

## Frequently Asked Questions

### Do I need my own developer credentials to use Sumble with Composio?

Yes, Sumble requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

### Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview).

### Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev).

### What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)
