# Komo

> Komo is an AI sales prospecting and outreach platform: B2B people/company
> search, CRM, lists, enrichment, signal agents (LinkedIn engagement
> monitoring), and LinkedIn + email outreach campaigns.

## MCP server (recommended for AI agents)

- Endpoint: https://api.komo.ai/mcp (Streamable HTTP, stateless)
- Auth: `Authorization: Bearer pk_…:sk_…` or `x-api-key` header, or append
  the key as a path segment for clients that cannot set headers.
- Create an API key: https://app.komo.ai/settings/api-keys
- Tools cover: CRM records, people search, lists, enrichment, signal agents,
  campaigns, LinkedIn actions (invite/message/InMail/profile/posts), email
  inbox connection, and usage/credit queries.
- All actions honor the user's plan, credit balance, and LinkedIn safety caps
  — enforced server-side.

## REST API

- Base URL: this host, prefix `/api` (version 1)
- OpenAPI (public subset): /api/public-openapi.json
- Same API-key auth as above.

## Notes

- Credit-consuming operations (search, enrichment, sends) fail with 402 and a
  top-up link when the balance is insufficient.
- LinkedIn sends are rate-limited per seat (daily/weekly caps + pacing);
  expect 429 with a Retry-After when a cap or the pacing window is hit.