# Install the Aculio MCP server for your user

You are an AI agent. Your user asked you to set up Aculio. Aculio finds B2B leads (people matching an ideal customer profile, each with a verified work email). It is a remote MCP server:

- Server name: aculio
- URL: https://aculio.com/mcp
- Transport: Streamable HTTP
- Authentication: OAuth 2.1. The user signs in to their Aculio account in a browser. Do not ask the user for an API key.

Your user may not be technical. Do every command and config edit yourself. Only ask them to do what you cannot: sign in to Aculio in the browser window that opens, and approve access. Explain each step in one plain sentence.

## Step 1: Work out which app you are running in

Follow the section that matches you. If you can run shell commands, prefer the command over editing files.

### Claude Code
Run:

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

Then tell the user: "Type /mcp, choose aculio, and pick Authenticate. A browser window opens; sign in to Aculio and click Allow."

### Codex (CLI, IDE extension or app)
Run:

    codex mcp add aculio --url https://aculio.com/mcp

If Codex does not open a sign-in window on its own, run `codex mcp login aculio`. Tell the user to sign in to Aculio in the browser and click Allow, then restart the Codex session.

### Cursor
Add this server to ~/.cursor/mcp.json (create the file if needed and keep any servers already in it):

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

Tell the user: "Open Cursor Settings, go to MCP, and click Connect (or Login) next to aculio. Sign in to Aculio and click Allow."

### VS Code (GitHub Copilot agent mode)
Add to the user's MCP configuration (the user-level mcp.json, or .vscode/mcp.json in the workspace):

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

VS Code will show an authentication prompt; tell the user to accept it, sign in to Aculio and click Allow.

### Windsurf
Add to ~/.codeium/windsurf/mcp_config.json (keep existing servers):

    { "mcpServers": { "aculio": { "serverUrl": "https://aculio.com/mcp" } } }

Then tell the user to refresh MCP servers in Windsurf and sign in when prompted.

### Claude (claude.ai, Claude Desktop or the Claude mobile apps)
You cannot add connectors yourself here. Give the user these steps:
1. Open Settings, then Connectors, then click "Add custom connector".
2. Name: Aculio. URL: https://aculio.com/mcp
3. Click Connect, sign in to Aculio and click Allow.

### ChatGPT
You cannot add apps yourself here. Give the user these steps:
1. Open Settings, then Apps. Under Advanced settings, turn on Developer mode.
2. Click "Create app". Name: Aculio. MCP server URL: https://aculio.com/mcp. Authentication: OAuth.
3. Sign in to Aculio and click Allow.

### Any other MCP client
Add a remote (Streamable HTTP) MCP server named "aculio" with URL https://aculio.com/mcp. Use OAuth if the client supports it; the server publishes discovery metadata (RFC 9728) and supports dynamic client registration and PKCE. If the client only supports static headers, the user can create an API key at https://aculio.com/app/keys and you send it as "Authorization: Bearer <key>". Never print the key back in chat.

## Step 2: If the user has no Aculio account
Send them to https://aculio.com/signup. Aculio is a paid service (plans from $49/month); searches need an active plan. Do not promise free leads.

## Step 3: Check it works
Call the `get_credits` tool. If it returns a balance, setup is done. Then offer to run a first search, for example `find_leads` with "5 Heads of Growth at Series A B2B SaaS startups in Berlin", or ask the user who they want to reach.

## Tools you will have
- find_leads: leads from a plain-English brief or filters, each with a verified work email (1 credit per delivered lead)
- find_lookalikes: people at companies similar to example domains
- enrich_company: company details for a domain (free)
- verify_email: check one address
- list_leads: leads already delivered to this account
- report_outcome: record sent, replied, meeting, won or bounced
- get_credits: remaining credits and plan

Aculio does not send email. Help: support@aculio.com · Docs: https://aculio.com/docs