# How to integrate AI Ark MCP with Atomic Agent

```json
{
  "title": "How to integrate AI Ark MCP with Atomic Agent",
  "toolkit": "AI Ark",
  "toolkit_slug": "ai_ark",
  "framework": "Atomic Agent",
  "framework_slug": "atomic-agent",
  "url": "https://composio.dev/toolkits/ai_ark/framework/atomic-agent",
  "markdown_url": "https://composio.dev/toolkits/ai_ark/framework/atomic-agent.md",
  "updated_at": "2026-10-25T05:31:19.876Z"
}
```

## 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](https://atomicagent.io/docs/?cta_placement=atomic-agent-docs) for installation instructions.

## Also integrate AI Ark with

- [ChatGPT](https://composio.dev/toolkits/ai_ark/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/ai_ark/framework/claude-cowork)
- [Hermes](https://composio.dev/toolkits/ai_ark/framework/hermes-agent)

## TL;DR

### 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

### Connect AI Ark to Atomic Agent
- Sign up or sign in to the [Composio dashboard](https://dashboard.composio.dev/?cta_placement=atomic-agent-api-key). Copy your API key.
- 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.
- Ask Atomic Agent to do something in AI Ark. It searches Composio for the right tool.
- 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.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `AI_ARK_ANALYZE_PERSONALITY` | Analyze Personality | Infer DISC and OCEAN personality assessments plus selling and hiring outreach guidance from one person's LinkedIn profile. This costs 4 AI Ark credits per request and returns sensitive algorithmic inferences, not verified or objective facts. |
| `AI_ARK_CREATE_OR_UPDATE_LIST` | Create or Update List | Create or mutate a temporary people/company exclusion list for free. Lists expire after 24 hours, hold at most 10,000 values, and are limited to 50 new lists per day. APPEND merges values; REPLACE irreversibly overwrites the complete prior list. Omitting list_id creates a list, and an unknown list_id can also create new state. |
| `AI_ARK_ENRICH_PERSON_WITH_EMAIL` | Enrich Person with Email | Enrich one person by AI Ark person ID or LinkedIn URL with a full profile and provider email-verification metadata. This returns sensitive personal profile and email data and is an enrichment action, not a standalone email verifier. It costs 1 credit only when a valid email is found and 0 credits otherwise. |
| `AI_ARK_FIND_MOBILE_PHONE` | Find Mobile Phone | Find candidate mobile phone numbers for one person from a LinkedIn URL or from a company domain plus full name. A found result costs 5 AI Ark credits; a no-result response costs 0 credits. The response contains sensitive personal phone numbers ordered by provider confidence, and AI Ark does not document them as verified. |
| `AI_ARK_GET_CREDITS` | 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. |
| `AI_ARK_GET_EMAIL_FINDER_STATUS` | Get Email Finder Status | Make one free status request for an email-finder job and return its state and total/found counts. This action does not poll internally or start another billable lookup; call it again only when another status check is needed. |
| `AI_ARK_GET_PEOPLE_EXPORT_STATUS` | 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. This action does not poll internally; call it again only when another status snapshot is needed. |
| `AI_ARK_LIST_EMAIL_FINDER_RESULTS` | List Email Finder Results | Return one free page of an email-finder job's results without waiting for completion. Entries still in PROCESSING state are preserved alongside completed entries. The response can contain sensitive personal email addresses, lookup inputs, and full provider verification and MX metadata. |
| `AI_ARK_LIST_EMAIL_FINDER_SUBMISSIONS` | 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. The provider automatically scopes results to the authenticated API key; callers control filters, repeated sort criteria, and pagination, and this action makes one request without polling or automatic pagination. |
| `AI_ARK_LIST_PEOPLE_EXPORT_RESULTS` | List People Export Results | Return one free page of a completed bulk people export. The response contains sensitive full person and company profiles and personal emails with provider verification metadata. This action does not poll internally; a still-processing export returns 409, so check GET_PEOPLE_EXPORT_STATUS until its state is DONE before trying again. |
| `AI_ARK_LIST_PEOPLE_EXPORT_SUBMISSIONS` | List People Export Submissions | List the authenticated API token's own people-export submission and refund history for free. Results are automatically scoped to the caller's customer account and this action returns one explicitly selected page without polling. |
| `AI_ARK_LOOK_UP_PERSON_BY_EMAIL` | Look Up Person by Email | Identify and return a sensitive, detailed personal and employment profile from an email address. AI Ark charges 0.5 credits per request, including when no profile is found. This action does not verify the input email and does not return a mobile number. |
| `AI_ARK_PREVIEW_PEOPLE` | Preview People | Return one page of masked people and full company matches for 1 credit per page. The preview contains no email or phone data and its trackId is null, so it cannot start email finding. |
| `AI_ARK_RESEND_EMAIL_FINDER_WEBHOOK` | Resend Email Finder Webhook | Irreversibly resend one email-finder completion payload to a caller-selected public HTTPS webhook. This free action externally discloses sensitive verified personal emails, may target a different URL from the original submission, and must not be retried after an ambiguous outcome. Success is reported only when AI Ark explicitly confirms delivery. |
| `AI_ARK_RESEND_PEOPLE_EXPORT_WEBHOOK` | Resend People Export Webhook | Irreversibly resend one completed bulk people export to a caller-selected public HTTPS webhook. This free action externally discloses sensitive full profiles and verified personal emails, may target a different URL from the original submission, and must not be retried after an ambiguous outcome. Success is reported only when AI Ark explicitly confirms delivery. |
| `AI_ARK_SEARCH_COMPANIES` | Search Companies | Return one zero-based page of companies using typed company, employee, list, and lookalike filters. Each returned company costs 0.1 AI Ark credits. Lookalike search accepts 1-5 domains or LinkedIn company URLs, page must be 0 or greater, size must be 1-100, and the result set is capped at 10,000 matches. |
| `AI_ARK_SEARCH_PEOPLE` | Search People | Return one page of full people and company profiles. This search costs 0.5 credits per returned person and does not return email addresses or phone numbers, but its personal and employment profile data is sensitive. The returned provider trackId (exposed as track_id) can be used once to start email finding and expires 6 hours after this search. |
| `AI_ARK_START_EMAIL_FINDER` | Start Email Finder | Consume a People Search track ID exactly once, within 6 hours of the search, to start email finding. A required external HTTPS webhook receives sensitive personal email results. This costs 1 credit per valid email found and 0 credits for people without a valid email. Use GET_EMAIL_FINDER_STATUS to monitor the job and LIST_EMAIL_FINDER_RESULTS to retrieve partial or completed results. |
| `AI_ARK_START_PEOPLE_EXPORT` | 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. AI Ark charges 0.5 credits per exported person plus 0.5 credits per valid email found, so the explicit maximum charge is size credits. Do not retry an ambiguous outcome because a duplicate submission can incur another charge and external delivery. |

## Supported Triggers

None listed.

## 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](/pricing) for the current limits that apply to your connection.

## Complete Code

None listed.

## Conclusion

### 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](https://atomicagent.io/?cta_placement=atomic-agent-site) or inspect the [Atomic Agent source code](https://github.com/AtomicBot-ai/atomic-agent?cta_placement=atomic-agent-repo).

## How to build AI Ark MCP Agent with another framework

- [ChatGPT](https://composio.dev/toolkits/ai_ark/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/ai_ark/framework/claude-cowork)
- [Hermes](https://composio.dev/toolkits/ai_ark/framework/hermes-agent)

## Related Toolkits

- [Ashby](https://composio.dev/toolkits/ashby) - Ashby is an applicant tracking system that handles job postings, candidate management, and hiring analytics.
- [7shifts](https://composio.dev/toolkits/7shifts) - 7shifts is a restaurant team management platform for scheduling, time clocks, payroll, and team communication. It helps operators keep labor, shifts, and staff workflows organized in one place.
- [Async interview](https://composio.dev/toolkits/async_interview) - Async interview is an on-demand video interview platform for streamlined hiring. Candidates record responses on their schedule, so employers can review anytime.
- [Bamboohr](https://composio.dev/toolkits/bamboohr) - BambooHR is a cloud-based HR management platform for small and mid-sized businesses. It streamlines employee data, HR workflows, and reporting in one easy interface.
- [Breathe HR](https://composio.dev/toolkits/breathehr) - Breathe HR is cloud-based HR software for SMEs to manage employee data, absences, and performance. It simplifies HR admin, making it easy to keep employee records accurate and up to date.
- [Breezy Hr](https://composio.dev/toolkits/breezy_hr) - Breezy HR is a recruiting and applicant tracking platform for managing jobs, candidates, pipelines, and hiring teams. It helps teams move faster from job posting to offer without losing track of applicants.
- [Connecteam](https://composio.dev/toolkits/connecteam) - Connecteam is a workforce management platform for deskless teams, streamlining operations, HR, and team communication. It helps businesses save time by automating scheduling, time tracking, and staff engagement tasks.
- [ContactOut](https://composio.dev/toolkits/contactout) - ContactOut is a professional profile enrichment and contact discovery API. Find and verify email addresses to power recruiting, sales, and outreach.
- [Coresignal](https://composio.dev/toolkits/coresignal) - Coresignal is a real-time public web data platform for employee, company, and professional profile intelligence. It helps teams access fresh workforce data for research, recruiting, sales, and market analysis.
- [Deputy](https://composio.dev/toolkits/deputy) - Deputy is a workforce management platform for scheduling, employees, timesheets, leave, and workplace locations. It helps teams simplify staff planning, time tracking, and daily workforce operations.
- [Dice MCP](https://composio.dev/toolkits/dice_mcp) - Dice MCP is an MCP server for searching Dice's tech-job database by role, company, location, and employment type. It helps agents find relevant tech roles fast with conversational filters.
- [Greenhouse](https://composio.dev/toolkits/greenhouse) - Greenhouse is applicant tracking and recruiting software for managing jobs, candidates, interviews, and hiring workflows. It helps recruiting teams move faster with structured pipelines, collaboration tools, and hiring data in one place.
- [Gusto](https://composio.dev/toolkits/gusto) - Gusto is a payroll, benefits, and HR platform for small and medium businesses. It helps teams run payroll, manage people, and stay compliant with less busywork.
- [Hireflix](https://composio.dev/toolkits/hireflix) - Hireflix is a one-way video interview platform for hiring teams. It helps teams manage positions, candidate interviews, templates, and branded hiring workflows in one place.
- [HR Partner](https://composio.dev/toolkits/hr_partner) - HR Partner is a human resources platform for managing employee records, leave, recruitment, performance, timesheets, and expenses. Use it to centralize HR workflows, automate manual HR tasks, and keep employee data organized.
- [Job Search (Rapid API)](https://composio.dev/toolkits/job_search) - Job Search (Rapid API) is a unified service that searches approved job-listing sources via RapidAPI hosts. Use it to aggregate and query listings across providers with a single API.
- [Lever](https://composio.dev/toolkits/lever) - Lever is an applicant tracking system that blends sourcing, CRM, and analytics for recruiting. It helps companies scale hiring with collaborative workflows and actionable insights.
- [Personio](https://composio.dev/toolkits/personio) - Personio is an HR platform for managing employee records, attendance, absences, projects, and documents. It centralizes HR data and streamlines workforce administration for teams and HR leaders.
- [Recruitee](https://composio.dev/toolkits/recruitee) - Recruitee is collaborative hiring software that centralizes recruitment tasks for teams. It streamlines sourcing, interviewing, and hiring so you can fill roles faster.
- [Remote retrieval](https://composio.dev/toolkits/remote_retrieval) - Remote retrieval is a logistics automation tool for managing laptop and monitor returns. It streamlines return tracking, saving time and hassle for IT and ops teams.

## Frequently Asked Questions

### What are the differences in Tool Router MCP and AI Ark MCP?

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.

### Can I use Tool Router MCP with Atomic Agent?

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.

### Can I manage the permissions and scopes for AI Ark while using Tool Router?

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.

### How safe is my data with Composio Tool Router?

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.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)