---
title: "Developers and AI agents"
description: "Run Acquisity cold email campaigns and CRM records from Claude, ChatGPT, Cursor or your own code with the Acquisity MCP server and REST API."
canonical: https://www.acquisity.ai/developers
---

# Developers and AI agents

> Run Acquisity cold email campaigns and CRM records from Claude, ChatGPT, Cursor or your own code with the Acquisity MCP server and REST API.

## MCP server

- URL: https://api.acquisity.ai/mcp (Streamable HTTP, stateless; send JSON-RPC with POST)
- Sign-in: OAuth 2.1 with dynamic client registration. The person picks one workspace and Read-only or Full access. No API key needed. Step by step: [auth.md](https://www.acquisity.ai/auth.md).
- Protected resource metadata: https://api.acquisity.ai/.well-known/oauth-protected-resource
- Authorization server: https://app.acquisity.ai/api/auth (scopes `mcp:read`, `mcp:write`, `offline_access`)
- Setup guides: [Claude](https://developer.acquisity.ai/mcp/claude-desktop), [Claude Code](https://developer.acquisity.ai/mcp/claude-code), [Cursor](https://developer.acquisity.ai/mcp/cursor), [Codex](https://developer.acquisity.ai/mcp/codex)

Add it to Claude Code:

```bash
claude mcp add --transport http acquisity https://api.acquisity.ai/mcp
```

### Cold email campaign tools

list_workspaces, get_workspace, list_campaigns, get_campaign, get_campaign_metrics, create_campaign, update_campaign, duplicate_campaign, set_campaign_sequence, copy_campaign_sequence, validate_campaign, launch_campaign, pause_campaign, preview_lead_search, search_leads, ai_search_leads, preview_campaign_lead_search, search_campaign_leads, ai_search_campaign_leads, add_campaign_leads, list_campaign_leads, get_campaign_lead, export_campaign_leads, get_operation, create_webhook.

### CRM tools

search_crm, plus list, get, create and update for people, companies, deals, tasks and notes; pipelines and stages; members; custom fields; and links between people, companies and deals. There are no delete, merge, messaging or payment tools.

## REST API

- Base URL: https://api.acquisity.ai/v1 (versioned in the path; [versioning and deprecation policy](https://developer.acquisity.ai/versioning): at least 90 days' notice with `Deprecation` and `Sunset` headers)
- OpenAPI: https://api.acquisity.ai/openapi.json
- Interactive reference: https://api.acquisity.ai/docs
- Auth: `Authorization: Bearer <key>`. Workspace keys start `acq_org_`, personal tokens start `acq_live_`. Create them in the app under Settings → Workspace API Keys.
- Writes accept an `Idempotency-Key` header. Long-running writes return `202` with `Location: /v1/operations/{id}`; poll the operation until it finishes.
- Updating a campaign needs `If-Match` with the `updatedAt` from your last read.

## A typical cold email run

1. `list_workspaces` and pick the workspace.
2. `create_campaign` (a draft; nothing is sent).
3. `ai_search_campaign_leads` to turn the brief into filters, `preview_campaign_lead_search` to count matches (free), then `search_campaign_leads` to attach verified leads (about 1 credit each). Or `add_campaign_leads` with your own list.
4. `set_campaign_sequence` to attach or generate the emails.
5. `validate_campaign` until it reports no blockers, then `launch_campaign`.
6. Poll `get_campaign_metrics`, or call `create_webhook` to hear about replies.

Ask the person before you launch a campaign or buy leads: launching sends real email and buying leads spends credits.

## Agent skills

Step-by-step skills for agents, listed at /.well-known/agent-skills/index.json and published with the MCP server as a plugin at https://github.com/Acquisity/skills (`npx skills add Acquisity/skills`, or `/plugin marketplace add Acquisity/skills` in Claude Code):

- [acquisity-cold-email-campaign](https://www.acquisity.ai/.well-known/agent-skills/acquisity-cold-email-campaign/SKILL.md): plan, build, check and launch a campaign
- [acquisity-campaign-results](https://www.acquisity.ai/.well-known/agent-skills/acquisity-campaign-results/SKILL.md): report results and who replied

## Discovery

- Agent catalog: /.well-known/ard.json (also /.well-known/ai-catalog.json)
- MCP server card: /.well-known/mcp/server-card.json
- API catalog (RFC 9727): /.well-known/api-catalog

## Docs for agents

- Docs MCP server (read-only, no sign-in): https://www.acquisity.ai/mcp with tools `search_acquisity_docs` and `get_acquisity_page`
- NLWeb search: https://www.acquisity.ai/ask?query=... (JSON, or SSE with `Accept: text/event-stream`)

## Documentation

- [Developer docs](https://developer.acquisity.ai): getting started, authentication, scopes, rate limits, guides
- [Help center](https://app.acquisity.ai/docs): Cold Email Agent, AI SDR and CRM guides for customers

---

Web page: https://www.acquisity.ai/developers
Site index for agents: https://www.acquisity.ai/llms.txt