How to integrate AI Ark MCP with Atomic Agent

Connect Atomic Agent to AI Ark MCP. Find software engineers in san francisco, enrich contact details for target companies, and more using natural language, with authentication handled for you.

AI Ark logoAI Ark
Api Key

AI Ark is a people and company intelligence platform with search, enrichment, and recruiting APIs. It helps teams find accurate contact data and discover hiring insights faster.

19 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 AI Ark.

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

Also integrate AI Ark with

How Atomic Agent connects to AI Ark

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

The AI Ark MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your AI Ark account. It provides structured and secure access to people and company search, contact enrichment, recruiting intelligence, email finding, and export tools, so your agent can find prospects, research companies, enrich professional profiles, assess personality insights, and retrieve contact information on your behalf.

  • People and company discovery: Have your agent search for people and companies using professional, employee, list, and lookalike filters.
  • Profile enrichment: Let the agent enrich a person’s profile from a LinkedIn URL or AI Ark record, or look up a detailed professional profile by email address.
  • Recruiting intelligence: Direct your agent to analyze a person’s DISC and OCEAN personality traits and generate selling or hiring outreach guidance from their LinkedIn profile.
  • Contact information research: Instruct your agent to find candidate mobile phone numbers or start email finding for people discovered through AI Ark search.
  • Export and job tracking: Have your agent start people exports, check email finder and export progress, retrieve available results, review submission history, and resend completion webhooks.

Use AI Ark from Atomic Agent

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

Analyze Personality

Infer DISC and OCEAN personality assessments plus selling and hiring outreach guidance from one person's LinkedIn profile.

Create or Update List

Create or mutate a temporary people/company exclusion list for free.

Enrich Person with Email

Enrich one person by AI Ark person ID or LinkedIn URL with a full profile and provider email-verification metadata.

Find Mobile Phone

Find candidate mobile phone numbers for one person from a LinkedIn URL or from a company domain plus full name.

Get Credit Balance

Return the connected AI Ark account's remaining credit balance for free; this is the only action safe to use for credential validation.

Get Email Finder Status

Make one free status request for an email-finder job and return its state and total/found counts.

Get People Export Status

Make one free status request for a bulk people-export job and return its state, total/found/success/failed counts, and webhook metadata.

List Email Finder Results

Return one free page of an email-finder job's results without waiting for completion.

List Email Finder Submissions

Return one free page of the connected AI Ark customer's email-finder submission history, including job states and refund details.

List People Export Results

Return one free page of a completed bulk people export.

List People Export Submissions

List the authenticated API token's own people-export submission and refund history for free.

Look Up Person by Email

Identify and return a sensitive, detailed personal and employment profile from an email address.

Preview People

Return one page of masked people and full company matches for 1 credit per page.

Resend Email Finder Webhook

Irreversibly resend one email-finder completion payload to a caller-selected public HTTPS webhook.

Resend People Export Webhook

Irreversibly resend one completed bulk people export to a caller-selected public HTTPS webhook.

Search Companies

Return one zero-based page of companies using typed company, employee, list, and lookalike filters.

Search People

Return one page of full people and company profiles.

Start Email Finder

Consume a People Search track ID exactly once, within 6 hours of the search, to start email finding.

Start People Export

Irreversibly start one paid asynchronous export of up to 10,000 matching people and deliver full personal profiles with real-time verified emails to a required external HTTPS webhook.

FAQ

Frequently asked questions

With a standalone AI Ark MCP server, the agents and LLMs can only access a fixed set of AI Ark tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from AI Ark 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 AI Ark tools.

Yes, absolutely. You can configure which AI Ark 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 AI Ark data and credentials are handled as safely as possible.

Start with AI Ark.It takes 30 seconds.

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

Start building