How to integrate Ploid MCP with Atomic Agent

Connect Atomic Agent to Ploid MCP. Research prospects and enrich their identities, find public linkedin intelligence on prospects, and more using natural language, with authentication handled for you.

Ploid logoPloid
Api Key

Ploid is a people research and identity intelligence platform with public LinkedIn data and research APIs. It helps teams enrich identities and uncover useful professional insights quickly.

42 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,500+ apps through Composio, including Ploid.

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 Ploid account. See the Atomic Agent documentation for installation instructions.

Also integrate Ploid with

How Atomic Agent connects to Ploid

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 Ploid 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 Ploid. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Ploid 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 Ploid MCP server, and what's possible with it?

The Ploid MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Ploid account. It provides structured and secure access to people research, identity enrichment, public LinkedIn intelligence, and agent-powered research tools, so your agent can search for people, resolve identities, enrich contact details, investigate LinkedIn profiles and activity, and monitor relevant social updates on your behalf.

  • People discovery and research: Have your agent search for people by structured criteria, find identity candidates, resolve named individuals, and retrieve evidence-backed person research.
  • Identity and contact enrichment: Direct your agent to enrich a person with available work email, personal email, phone, or public social profile details.
  • LinkedIn intelligence: Let the agent find LinkedIn people and companies, inspect public profiles, review company details, and retrieve posts or comments from public profiles.
  • Targeted talent research: Instruct your agent to search GitHub accounts and people, connect relevant GitHub accounts with indexed LinkedIn people, or list recruiters and role counts for selected companies.
  • Ongoing research and data workflows: Have your agent create datasets, track research results, create and run scheduled social monitors, and review monitor activity and emitted updates.

Use Ploid from Atomic Agent

With your account connected, ask Atomic Agent to work with Ploid 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 Ploid action and event your agent gets out of the box.

Cancel Person Run

Irreversibly cancel an active deep-person research run.

Cancel People Set

DESTRUCTIVE: irreversibly stop the active search for a preview People Set.

Compile Monitor

Preview a social-monitor plan, resolved targets, relevance rules, and output schema without creating a monitor or scheduling runs.

Create Dataset

Create a persistent typed dataset and fill 1-30 columns for seeded people, companies, or custom entities.

Create Monitor

Create a persistent scheduled social monitor and immediately start a silent baseline run.

Create People Set

Create a persistent preview People Set and start durable verified background work that may continue after this call returns.

Delete Monitor

Destructively and irreversibly disable a monitor.

Enrich Person Contact

Resolve requested work email, personal email, and/or phone fields for one person.

Enrich Social Profile

Resolve one public social profile from a supported platform handle, vanity slug, or profile URL.

Export People Set

Export admitted items from a preview People Set.

Get Account Credits

Return the workspace ACU balance and the calling API key's daily and monthly spending-budget state.

Get Account Profile

Return the signed-in user's WorkOS-linked Ploid account profile.

Get Account Usage

Preferred connection diagnostic for verifying which Ploid workspace and API key are connected.

Get Dataset

Return a dataset's lifecycle status, configured columns, row-processing progress, and rows URL.

Get LinkedIn Company

Fetch public LinkedIn company details by URL, universal name, or search term; provide at least one of those locators.

Get LinkedIn Profile

Fetch one public LinkedIn profile by full URL, vanity slug, or @handle.

Get Monitor

Return one monitor and its current configuration.

Get Monitor Run

Return one monitor run by monitor and run ID, including lifecycle state, usage, error, and webhook delivery outcome.

Get Person

Get an evidence-backed reviewed person record or start a durable research run.

Get Person Run

Get the current state or terminal result of a deep-person research run.

Get People Set

Return a preview People Set's status, progress, and searches, newest first.

List Company Recruiters

Return recruiters and role counts for up to 10 companies.

List Dataset Rows

Return one integer-cursor page of dataset rows in seed order, including rows available before asynchronous processing finishes.

List LinkedIn Company Posts

Return one provider page of posts for a LinkedIn company.

List LinkedIn Posts

Return up to 20 recent posts for one public LinkedIn profile identified by profile URL, vanity slug, or @handle; provide identifier or its url alias.

List LinkedIn Profile Comments

Return one provider page of comments made by a LinkedIn profile.

List Monitor Items

Return one cursor-controlled page of emitted monitor items, optionally limited to one run.

List Monitor Runs

Return one cursor-controlled page of a monitor's runs, newest first.

List Monitors

Return one cursor-controlled page of monitors, newest first.

List People Set Items

Return one caller-controlled page of admitted, criterion-verified people while or after a preview People Set runs.

List People Sets

List the workspace's recent People Sets.

Resolve Person

Resolve a named person plus at least one identity clue to a permanent Ploid person ID.

Run Monitor

Queue a persistent monitor run now.

Search GitHub Accounts

Search Ploid's GitHub account index by profile, repository, language, and activity filters.

Search GitHub People

Search GitHub accounts, link unambiguous accounts to indexed LinkedIn people, and enforce optional LinkedIn filters as hard requirements.

Search LinkedIn People

Return one cursor-controlled page of public LinkedIn people matching structured keyword, location, title, current-company, and school filters.

Search People

Search for up to 150 people and return typed results inline.

Search People Candidates

Search the indexed people directory for up to 10 unverified identity candidates.

Test Monitor

Fetch and evaluate a monitor's current targets without saving a run, items, seen-ledger entries, or snapshots; sending a webhook; or changing its schedule.

Test Monitor Webhook

Immediately send one signed monitor.

Update Account Profile

REAL ACCOUNT MUTATION: replace the signed-in user's WorkOS-linked Ploid profile fields.

Update Monitor

Update, pause, or resume a monitor by providing at least one field to change.

FAQ

Frequently asked questions

With a standalone Ploid MCP server, the agents and LLMs can only access a fixed set of Ploid tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Ploid and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Ploid tools.

Yes, absolutely. You can configure which Ploid scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Ploid data and credentials are handled as safely as possible.

Start with Ploid.It takes 30 seconds.

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

Start building