otherapi_key

The Companies API

Search, enrich, and analyze company data, technologies, locations, lists, and related business intelligence.

Verdict

The Companies API MCP lets your team pull firmographic data and manage company lists without leaving Switchy. @mention it to look up a company profile by domain, normalize messy job titles into clean department and seniority labels, or create and maintain segmented lists for outreach or research. Sales, marketing, and ops teams get the most value — especially when building account lists or enriching CRM records on the fly. The MCP reads cached profiles by default, so you won't burn credits on every lookup unless you explicitly request a refresh.

Common use cases

  • Enrich inbound leads with firmographics
  • Normalize job titles in CRM imports
  • Build target account lists for campaigns
  • Check credit balance before bulk lookups
  • Segment companies by size or industry

Integration

Vendor
The Companies API
Category
other
Auth
API_KEY
Tools
10
Composio slug
thecompaniesapi

Tools

  • Create List

    Create an empty static company list with email notifications disabled.

  • Delete List
    destructive

    Permanently delete a company list by ID and return the deleted list record.

  • Enrich Job Title

    Normalize a job title and infer its department and seniority classification.

  • Get Account Context

    Return the connected user, current team, subscription state, and remaining credit balance.

  • Get Company

    Return the cached company profile for an exact domain, optionally in a compact form; this tool does not force a paid refresh.

  • List Companies In List

    Return one page of companies currently contained in a specified company list.

  • List Lists

    Return one page of company lists owned by the connected account.

  • Rename List

    Rename an existing company list without changing its query, synchronization, or notification settings.

  • Search Companies

    Search the company database with text or structured segmentation conditions and return one page of matching company profiles.

  • Search Taxonomy

    Search provider taxonomy values for industries, technologies, or geographic levels and return normalized identifiers for company filters.

Setup

Setup guide

  1. 11. In Switchy, open Settings → Integrations and click 'Add MCP'. 2. Search for 'The Companies API' and select it. 3. You'll be prompted to paste an API key; generate one from your Companies API dashboard under API Keys. 4. Copy the key and paste it into Switchy, then click 'Connect'. 5. Switchy will verify the key and display your account context (team name, subscription tier, remaining credits). 6. Open any Project and type '@The Companies API get company for stripe.com' to test; the MCP should return a cached profile with employee count, industry, and funding data. 7. If the response includes company details, the connection is live and ready for team use.

What teammates see: by default, memories from The Companies API are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Projects have used this MCP together with a given model.

How Switchy teams use it

Not enough Projects yet to publish anonymised usage stats (we require ≥ 50 Projects per week).

Starter prompts

Enrich Lead Domain

@The Companies API get the company profile for acme.com and summarize employee count, industry, and funding stage.

Normalize Job Titles

@The Companies API enrich the job title 'VP of Customer Success' and tell me the department and seniority level.

Create Target List

@The Companies API create a new list called 'Q2 Enterprise Targets' and confirm it's ready.

Check Credit Balance

@The Companies API show me the current credit balance and subscription tier for our account.

List Saved Companies

@The Companies API list the first 20 companies in the 'Q2 Enterprise Targets' list and show their domains.

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@the-companies-api look up the company profile for stripe.com and summarize their employee count, funding stage, and primary industry tags.

Output

Stripe's cached profile shows approximately 8,000 employees, classified as a late-stage venture-backed company (Series I). Primary industry tags include financial services, payments infrastructure, and developer tools. The profile was last refreshed 14 days ago. Note that this is a cached lookup—no credit was consumed, but data may be stale if Stripe recently announced headcount changes or a new funding round.

Notes

This example uses the Get Company tool in read-only mode, pulling from The Companies API's cache without triggering a paid refresh. Ideal for quick lookups when recency isn't critical. If you need live data, you'll need to call a separate enrichment endpoint (not shown here) which consumes account credits.

Prompt

@the-companies-api create a new list called 'Q1 Enterprise Prospects' and add it to my account so I can track target companies for outreach.

Output

Created list 'Q1 Enterprise Prospects' (ID: lst_9x4k2m). The list is currently empty and email notifications are disabled by default. You can now populate it by adding companies manually or syncing it with a saved search query. The list appears in your account dashboard and can be shared with teammates who have access to your team workspace.

Notes

This demonstrates the Create List tool, which provisions a new static list but does not populate it. You'll need follow-up actions (adding companies, configuring sync rules) to make the list useful. Be aware that list operations count toward your account's resource limits, and deleting a list is permanent.

Prompt

@the-companies-api normalize the job title 'VP of Revenue Operations' and tell me what department and seniority level it maps to in your taxonomy.

Output

Normalized title: 'Vice President of Revenue Operations'. Department classification: Revenue Operations (a hybrid of Sales Operations and Marketing Operations). Seniority: Executive (C-suite adjacent, typically reports to CRO or CFO). This classification is based on The Companies API's standardized job taxonomy, which groups ~12,000 raw titles into 400 canonical roles across 25 departments and 5 seniority tiers.

Notes

The Enrich Job Title tool is useful for cleaning messy contact data before segmentation or scoring. It infers department and seniority but does not validate whether a specific person holds this title—it's a linguistic normalization, not a live lookup. Pair this with contact enrichment tools if you need to verify actual employment records.

Use-case deep-dives

Outbound sales list segmentation

When static company lists beat your CRM's native filters

A 6-person sales team closing mid-market SaaS deals needs to segment 400 inbound leads by industry and headcount before the Monday pipeline review. The Companies API's list tools let you create, populate, and rename segments in real time without waiting for CRM sync delays or fighting Salesforce formula limits. Use Get Company to pull firmographic snapshots, then bucket leads into static lists that stay frozen while reps work them. The trade-off: this MCP doesn't write back to your CRM, so you're managing two sources of truth. If your team already lives in HubSpot or Salesforce and trusts its enrichment, skip this. If you're stitching together Apollo, Clearbit, and spreadsheets, these list primitives clean up the chaos. Worth it when you're moving faster than your CRM's nightly batch jobs.

Customer success account prioritization

How to triage expansion accounts by firmographic signals

A 3-person CS team managing 80 accounts needs to spot which customers are growing fast enough to justify an upsell motion this quarter. The Companies API's Get Company tool surfaces headcount trends and funding events without forcing a paid refresh, so you can scan your book in minutes. Pair it with List Companies In List to pull a saved segment of high-intent accounts, then cross-reference against usage data in your product analytics tool. The ceiling: this MCP doesn't integrate with Gainsight or ChurnZero, so you're exporting context manually. If your CS platform already enriches accounts automatically, you don't need this. If you're running CS out of Notion and a spreadsheet, these firmographic lookups give you the signal to prioritize outreach before renewal conversations go cold.

Recruiting pipeline candidate sourcing

When job title normalization speeds up talent screening

A 2-person recruiting team at a 30-person startup is screening 200 LinkedIn profiles for a senior backend role and needs to filter out mis-titled candidates before scheduling calls. The Enrich Job Title tool normalizes messy titles like 'Code Wizard' or 'Fullstack Ninja' into standardized department and seniority tags, so you can programmatically separate senior ICs from junior generalists. Use Get Account Context to track your credit burn if you're on a metered plan. The limit: this MCP doesn't parse resumes or integrate with your ATS, so you're still copying data between tools. If you're already paying for LinkedIn Recruiter's advanced filters, you don't need this. If you're sourcing from Twitter, GitHub, or scraped lists where titles are chaos, this normalization step saves hours of manual triage before you hit send on outreach.

Frequently asked

What does The Companies API MCP do in Switchy?

It lets your team pull firmographic data on any company by domain, normalise job titles into department and seniority buckets, and manage static company lists for segmentation. Think of it as a B2B data enrichment layer you can call from any Switchy workflow without writing API code or managing credits manually across team members.

Do I need admin access to connect The Companies API?

No. The Companies API uses a simple API key, so any team member with a valid key can connect it to Switchy. You'll want to check your account's credit balance via the Get Account Context tool after connecting, since enrichment calls consume credits and you don't want workflows to fail mid-run when the balance hits zero.

Can this MCP enrich contacts or just companies?

Just companies. The MCP pulls firmographic profiles by domain and can normalise job titles into department and seniority labels, but it won't return individual contact records or email addresses. If you need person-level enrichment, pair this with a contact data MCP or use The Companies API's separate contact endpoints outside Switchy.

How does this compare to calling The Companies API directly?

The MCP saves you from writing HTTP clients and parsing JSON responses in every workflow. You also get shared credit visibility across your Switchy team via Get Account Context, so you won't burn through your balance unknowingly. The trade-off is you're limited to the ten tools exposed here—if you need a niche endpoint, call the REST API directly.

Who on the team should connect The Companies API?

Whoever owns your B2B data enrichment budget. Since all enrichment calls draw from a single credit pool tied to the API key, you want one person responsible for monitoring usage and topping up credits. Everyone else on the team can invoke the MCP in their workflows once it's connected.

More other MCPs

See all other MCPs →

Data last verified 61 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.