# AI Ark

```json
{
  "name": "AI Ark",
  "slug": "ai_ark",
  "url": "https://composio.dev/toolkits/ai_ark",
  "markdown_url": "https://composio.dev/toolkits/ai_ark.md",
  "logo_url": "https://logos.composio.dev/api/ai_ark",
  "categories": [
    "hr & recruiting"
  ],
  "is_composio_managed": false,
  "updated_at": "2026-10-25T05:31:19.876Z"
}
```

![AI Ark logo](https://logos.composio.dev/api/ai_ark)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with AI Ark MCP or direct API to search people, find companies, enrich contacts, and uncover recruiting intelligence through natural language.

## Summary

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.

## Categories

- hr & recruiting

## Toolkit Details

- Tools: 19

## Images

- Logo: https://logos.composio.dev/api/ai_ark

## Authentication

- **Api Key**
  - Type: `api_key`
  - Description: Api Key authentication for AI Ark.
  - Setup:
    - Configure Api Key credentials for AI Ark.
    - Use the credentials when creating an auth config in Composio.

## Suggested Prompts

- Find software engineers in San Francisco
- Enrich contact details for target companies
- Identify hiring managers at fintech startups

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

## Installation and MCP Setup

### Path 1: SDK Installation

#### Path 1, Step 1: Install Composio

Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
```python
pip install composio composio_openai openai
```

```typescript
npm install @composio/core @composio/openai openai
```

#### Path 1, Step 2: Create a Composio session

Initialize Composio with the OpenAI Responses provider and create a session scoped to AI Ark
```python
import json
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
client = OpenAI()

session = composio.create(user_id="your-user-id", toolkits=["ai_ark"])
tools = session.tools()
```

```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: ["ai_ark"] });
const tools = await session.tools();
```

#### Path 1, Step 3: Run AI Ark tools with your agent

Send a request, execute the AI Ark tool calls through the session, and print the final answer
```python
response = client.responses.create(
    model="gpt-5.6-sol",
    tools=tools,
    input=[{"role": "user", "content": "Find software engineers in San Francisco with their contact details"}],
)

while True:
    tool_calls = [o for o in response.output if o.type == "function_call"]
    if not tool_calls:
        break
    results = composio.provider.handle_tool_calls(response=response, session=session)
    response = client.responses.create(
        model="gpt-5.6-sol",
        tools=tools,
        previous_response_id=response.id,
        input=[
            {"type": "function_call_output", "call_id": call.call_id, "output": json.dumps(results[i])}
            for i, call in enumerate(tool_calls)
        ],
    )

print(response.output_text)
```

```typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Find software engineers in San Francisco with their contact details" }],
});

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);
```

### Path 2: MCP Server Setup

#### Path 2, Step 1: Install Composio

Install the Composio SDK and your agent framework
```python
pip install composio claude-agent-sdk
```

```typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
```

#### Path 2, Step 2: Create a session with MCP enabled

Create a session scoped to AI Ark and read its MCP URL and headers
```python
from composio import Composio

composio = Composio()
session = composio.create(user_id="your-user-id", toolkits=["ai_ark"], mcp=True)
```

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

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["ai_ark"],
  mcp: true,
});
```

#### Path 2, Step 3: Connect your agent to the MCP server

Pass the session's MCP URL and headers to your agent and run a AI Ark request
```python
import asyncio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions, AssistantMessage, TextBlock

options = ClaudeAgentOptions(
    mcp_servers={
        "composio": {
            "type": "http",
            "url": session.mcp.url,
            "headers": session.mcp.headers,
        }
    },
    system_prompt="You are a helpful assistant with access to AI Ark tools.",
    tools=[],
    allowed_tools=["mcp__composio__*"],
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query("Find software engineers in San Francisco with their contact details")
        async for message in client.receive_response():
            if isinstance(message, AssistantMessage):
                for block in message.content:
                    if isinstance(block, TextBlock):
                        print(block.text)

asyncio.run(main())
```

```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: "Find software engineers in San Francisco with their contact details",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
```

## Why Use Composio?

### 1. AI Native AI Ark Integration

- Supports both AI Ark MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable people, company, and contact searches
- Rich coverage for querying company data, enriching contacts, and finding recruiting signals

### 2. Managed Auth

- Securely stores and manages your AI Ark API keys
- Central place to manage, scope, and revoke AI Ark access
- Per user and per environment credentials instead of hard-coded keys

### 3. Agent Optimized Design

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

### 4. Enterprise Grade Security

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

## Use AI Ark with any AI Agent Framework

Choose a framework you want to connect 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)
- [Atomic Agent](https://composio.dev/toolkits/ai_ark/framework/atomic-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

### Do I need my own developer credentials to use AI Ark with Composio?

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

### Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview).

### Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev).

### What if the API changes?

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

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