How to integrate HarvestAPI MCP with Atomic Agent

Connect Atomic Agent to HarvestAPI MCP. Search linkedin for senior engineers in austin, enrich a linkedin profile with company data, and more using natural language, with authentication handled for you.

HarvestAPI logoHarvestAPI
Api Key

HarvestAPI is a recruiting and lead intelligence service for LinkedIn people and company data. It helps teams find prospects and enrich profiles with useful company insights.

32 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including HarvestAPI.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a HarvestAPI account. See the Atomic Agent documentation for installation instructions.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate HarvestAPI with

How Atomic Agent connects to HarvestAPI

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect HarvestAPI to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in HarvestAPI. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your HarvestAPI account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the HarvestAPI MCP server, and what's possible with it?

The HarvestAPI MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your HarvestAPI account. It provides structured and secure access to LinkedIn people, company, job, post, event, group, ad, and service search and enrichment tools, so your agent can find prospects and candidates, enrich professional and company profiles, research market activity, and gather recruiting and sales intelligence on your behalf.

  • People and lead discovery: Have your agent search LinkedIn profiles and leads by person, employer, title, location, industry, school, recruiting criteria, or sales filters.
  • Company research and enrichment: Let the agent find companies, enrich company profiles, review hiring and headcount trends, and gather revenue, competitor, news, and key-person insights.
  • Professional profile intelligence: Direct your agent to enrich a LinkedIn profile from a profile link, public identifier, or work email, then retrieve its posts, comments, and reactions.
  • LinkedIn content research: Instruct your agent to search and retrieve posts, comments, reactions, ads, events, groups, and service-provider profiles using relevant keywords and filters.
  • Recruiting and hiring research: Have your agent search LinkedIn jobs by title, company, location, work arrangement, employment type, salary, seniority, industry, or recency, then retrieve details for specific roles.

Use HarvestAPI from Atomic Agent

With your account connected, ask Atomic Agent to work with HarvestAPI in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every HarvestAPI action and event your agent gets out of the box.

Get LinkedIn Account Insights

Get broad LinkedIn company intelligence including company and revenue data, AI-generated sourced summaries, competitors, key people, headcount, hiring, news, suggested contacts, and alerts.

Get LinkedIn Ad

Get detailed creative, advertiser, impression, and targeting data for one LinkedIn ad.

Get LinkedIn Comment Reactions

Get one page of reactions to a LinkedIn comment.

Get LinkedIn Company

Enrich one LinkedIn company by company URL, universal name, or company ID.

Get LinkedIn Company People Stats

Return aggregate LinkedIn employee distributions for a company across location, school, function, skills, services, and fields of study.

Get LinkedIn Company Posts

Get one page of posts from a LinkedIn company.

Get LinkedIn Event

Get one LinkedIn event by URL or ID, including timing, venue, organizer, speakers, and announcement post.

Get LinkedIn Group

Get complete details for one LinkedIn group.

Get LinkedIn Job

Get complete details for one LinkedIn job.

Get My API User

Return details for the HarvestAPI user associated with the connected API key.

Get My Private Account Pools

Return private LinkedIn account-pool details associated with the connected HarvestAPI API user.

Get LinkedIn Post

Get one LinkedIn post by URL.

Get LinkedIn Post Comment Replies

Get one page of replies to a LinkedIn comment.

Get LinkedIn Post Comments

Get one page of comments for a LinkedIn post.

Get LinkedIn Post Reactions

Get one page of reactions to a LinkedIn post.

Get LinkedIn Profile

Enrich one LinkedIn profile by URL, public identifier, or profile ID.

Get LinkedIn Profile by Email

Reverse lookup a LinkedIn profile from a work email address.

Get LinkedIn Profile Comments

Get one page of comments authored by a LinkedIn profile, optionally limited by age.

Get LinkedIn Profile Posts

Use this dedicated profile feed to retrieve a profile's complete authored-post history one page at a time; unlike SEARCH_POSTS, it is intended for complete profile post retrieval.

Get LinkedIn Profile Reactions

Get one page of reactions made by a LinkedIn profile.

Search LinkedIn Accounts

Find LinkedIn companies with advanced recruiting and sales filters such as growth, hiring, department headcount, activity, and exclusions, returning one 25-result page.

Search LinkedIn Ads

Search the LinkedIn Ad Library by a complete search URL or structured keyword, advertiser, country, and date filters, returning one page.

Search LinkedIn Companies

Find LinkedIn companies by name keywords, location, size, or industry and return one controllable result page.

Search LinkedIn Events

Search LinkedIn events by keywords and return one controllable page.

Search LinkedIn Geo IDs

Resolve location text to LinkedIn Geo IDs for precise people and company search filters.

Search LinkedIn Groups

Search LinkedIn groups by keyword and return one controllable result page.

Search LinkedIn Jobs

Search LinkedIn jobs by title, company, location, work arrangement, employment type, salary, recency, seniority, industry, or function and return one controllable page.

Search LinkedIn Leads

Search LinkedIn people for recruiting candidates or sales prospects with advanced inclusion and exclusion filters, including a Sales Navigator search URL, and return one controllable result page.

Search LinkedIn Posts

Search LinkedIn posts by keywords, authors, companies, mentions, content type, group, and date controls, returning one page only.

Search LinkedIn Profiles

Search public LinkedIn profiles by person, employer, school, title, location, industry, or follower relationship and return one result page.

Search LinkedIn Services

Search LinkedIn service-provider profiles by service or name keywords and location.

Search LinkedIn Typeahead

Return LinkedIn search-bar suggestions or one page of company, school, or profile suggestions.

FAQ

Frequently asked questions

Start with HarvestAPI.It takes 30 seconds.

Managed auth, hosted MCP servers, and every HarvestAPI tool your agent needs.Free to start.

Start building