Ploid MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Ploid MCP or direct API to research people, enrich identities, analyze public LinkedIn intelligence, and gather agent-powered insights through natural language.

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

Try Ploid now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Ploid
Try asking
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.

SETUP GUIDE

Connect Ploid MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

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

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["ploid"],
  mcp: true,
});
Create a session scoped to Ploid and read its MCP URL and headers
3

Connect your agent to the MCP server

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: "Research Jane Smith, the VP of Sales at Acme, using public LinkedIn intelligence and summarize her current role, location, and professional background.",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Ploid request
SETUP GUIDE

Connect Ploid API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

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: ["ploid"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Ploid
3

Run Ploid tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Research Jane Smith, the VP of Sales at Acme, using public LinkedIn intelligence and summarize her current role, location, and professional background." }],
});

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);
Send a request, execute the Ploid tool calls through the session, and print the final answer

Why Use Composio?

AI Native Ploid Integration

  • Supports both Ploid MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable people research and identity enrichment
  • Rich coverage for querying public LinkedIn intelligence and research data

Managed Auth

  • Securely stores and applies your Ploid API key to tool requests
  • Central place to manage, scope, and revoke Ploid access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

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

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Ploid
  • Scoped, least privilege access to Ploid research resources
  • Full audit trail of agent actions to support review and compliance

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

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

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Yes. Composio is SOC 2 Type II compliant and is built to keep your Ploid connection and credentials secure. OAuth tokens and API keys are encrypted, and sensitive customer data is protected at rest and in transit.

Composio also undergoes independent security testing and continuously monitors its systems for security threats. You can review the latest reports and policies in the Composio Trust Center.

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

Create the key in your Ploid account settings, then paste it once on Composio's connection page. Composio stores it encrypted and uses it only for the Ploid actions your agent runs. Nobody else in your workspace can read it, and you can revoke it inside Ploid at any time.

When you connect a Ploid account through Composio, every action runs under that account, so anything the agent creates, sends, or changes shows up in Ploid as done by you. Keep an approval step in your prompt for actions with side effects, such as sending or deleting, and have the agent draft first.

Whatever the credentials you connect allow inside Ploid. If Ploid lets you scope a key to specific permissions, create a scoped one so the agent can only do what you intend. You can revoke the key inside Ploid at any time.

Yes. Composio supports multiple connected accounts for the same app, and that works in Claude, ChatGPT, or any other assistant you connect through Composio. Give each Ploid connection a name such as work or personal, and the assistant uses the one you mention in the request. Each account keeps its own credentials and nothing is merged.

The connection stops working the moment Ploid rejects the old key. Create a new key in Ploid and reconnect the account from the Composio dashboard or by asking your agent to reconnect Ploid. Nothing else changes.

Composio's free Hobby plan includes 100,000 tool calls per month with no credit card, which covers most personal Ploid use. Paid plans add higher limits and team features. Your Ploid plan and its API limits still apply as usual.

Built-in connectors usually give one AI access to a limited set of apps. Many people use Composio because it lets their AI connect to more apps than it normally supports, or connect to multiple accounts for the same app (e.g. connect Claude to multiple Ploid accounts).

With Composio, you connect Ploid once and then use it across different AI assistants without setting it up separately in each one. Connect your apps to Composio once, then connect Composio to whichever AI you use, whether that's Claude, ChatGPT, Hermes, or your own custom assistant.

Start with Ploid.It takes 30 seconds.

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

Start building