Skip to content
aculio

Aculio docs

Aculio exposes the same capabilities through an MCP server for AI agents and a REST API for everything else. Both authenticate with a bearer API key and spend one credit per verified lead.

Quickstart

  1. 01

    Create an API key

    Sign up, choose a plan and create a key under API & MCP in the app.

  2. 02

    Add the MCP server

    Run the install command in your terminal, or add the JSON config to your MCP client.

  3. 03

    Ask for leads

    Ask your agent something like “Get me 10 Heads of Growth at Series A fintechs in Berlin”.

Connect Aculio to your AI

The easiest way: paste this message into the AI you use (Claude Code, Codex, Cursor or another agent). It installs Aculio itself and only asks you to sign in.

Paste this into your AI

Set up Aculio for me by following the instructions at https://aculio.com/agent-setup. Do the technical steps yourself and only ask me to sign in.

Using Claude or ChatGPT in the browser or desktop app? Follow the three steps under Claude and ChatGPT below instead.

MCP server

Endpoint: https://aculio.com/mcp (Streamable HTTP). It uses OAuth sign-in, so most clients just need the URL: you sign in to Aculio in your browser and click Allow. Clients that only support static headers can send an API key as Authorization: Bearer <your key>. Instructions for agents: aculio.com/agent-setup.

Claude and ChatGPT

  1. In Claude: Settings → Connectors → Add custom connector. In ChatGPT: Settings → Apps, turn on Developer mode, then Create app. Use the URL https://aculio.com/mcp.
  2. Click Connect. You're sent to aculio.com: log in (or create an account) and click Allow.
  3. Ask for leads in plain English, for example “Get me 5 Heads of Growth at Series A fintechs in Berlin”.

No API key is needed for this. To disconnect, remove the connector in your AI app.

Manual setup: Claude Code

Run in your terminal, then type /mcp to sign in

$ claude mcp add --transport http aculio https://aculio.com/mcp

Manual setup: Cursor, Codex and other MCP clients

Add this to your client's MCP configuration (field names vary slightly between clients), then sign in when it asks:

{
  "mcpServers": {
    "aculio": {
      "type": "http",
      "url": "https://aculio.com/mcp"
    }
  }
}

Tools

Every tool returns JSON. Tools that return leads only charge for verified leads.

Aculio MCP tools
ToolWhat it doesArguments
find_leadsFind verified leads from a plain-English brief or structured filters.prompt?: string, filters?: { description, titles, industries, technologies, countries, locations, keywords, companySize, companyDomains, hiringFor, recentlyFundedWithinDays }, limit?: number (1-100)
find_lookalikesFind people at companies similar to example domains.domains: string[], titles?: string[], countries?: string[], limit?: number
enrich_companyCompany profile, size, industry and recent signals for a domain.domain: string
verify_emailCheck whether a work email is deliverable.email: string
report_outcomeTell Aculio what happened with a lead so it can rank future leads.lead_id?: string, email?: string, outcome: 'sent' | 'replied' | 'meeting' | 'won' | 'bounced' | 'not_interested'
list_leadsList leads already in your workspace, with filters.search_id?: string, status?: string, limit?: number, cursor?: string
get_creditsRemaining verified-lead credits and plan.none

REST API

Base URL: https://aculio.com/api/v1. Send either a plain-English prompt or structured filters, plus a limit (1–100).

curl -X POST https://aculio.com/api/v1/leads/search \
  -H "Authorization: Bearer $ACULIO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Heads of Growth at Series A fintechs in Berlin", "limit": 20}'

Main endpoints:

  • POST /leads/search: find verified leads
  • POST /leads/lookalikes: leads at companies like example domains
  • GET /leads: list leads in your workspace
  • POST /leads/:id/outcome: report an outcome
  • GET /credits: remaining credits and plan

Credits and errors

One credit is spent per verified lead returned. Searches check your balance first and use your plan's included leads first, then continue into overage at your plan's per-lead rate. Errors use standard HTTP codes with a JSON body { "error": { "code", "message" } }, for example 402 insufficient_credits or 401 invalid_api_key.

Troubleshooting

  • “Sign in required” or 401 errors: reconnect the connector in your AI app, or check that your API key starts with acu_ and hasn't been revoked under API & MCP in the app.
  • insufficient_credits: your plan's credits are used up. Choose or upgrade a plan under Billing.
  • Fewer leads than requested: Aculio only delivers people with a deliverable work email and skips anyone already in your account. Broaden titles, locations or industries and search again; you're only charged for leads delivered.
  • A search stopped early: searches return within about 95 seconds with the leads found so far. Run it again to get more.
  • The connection screen doesn't appear: allow pop-ups for your AI app and aculio.com, then retry.

Still stuck? Email support@aculio.com with the time and the request you made.

Outcomes

Aculio never sends email. To let it learn which leads get replies, connect Instantly, Smartlead, HubSpot or Attio in the app, or report results through the report_outcome tool or POST /api/v1/outcomes. Reported hard bounces return the credit for that lead.

Questions? Email support@aculio.com or create an account.