# OutreachAgent

> API-first email infrastructure for AI agents. Send, receive, parse, personalize, and act on emails safely.

## Docs

- [Full LLM Context](https://outreachagent.dev/llms-full.txt): Complete API reference, data model, SDK methods, and recipes in a single file optimized for LLM context windows.
- [OpenAPI Spec](https://api.outreachagent.dev/v1/openapi.json): Machine-readable OpenAPI 3.1 specification for every endpoint.
- [Best Practices](https://outreachagent.dev/docs/best-practices): Domain setup, contact verification, sending guidelines, testing checklist, and common mistakes to avoid.
- [Documentation](https://outreachagent.dev/docs): Interactive documentation site with guides and examples.

## API

- Base URL: `https://api.outreachagent.dev/v1`
- Auth: Bearer token via `Authorization` header. API keys are prefixed with `rm_`.
- Rate limit: 100 requests/minute per organization.

## SDKs

- TypeScript: `npm install @outreachagent/sdk-ts`
- Python: `pip install outreachagent`

## MCP Server (Model Context Protocol)

- Package: `@outreachagent/mcp`
- Install: `npx @outreachagent/mcp` (stdio transport, no HTTP server needed)
- Exposes all 75 SDK methods as MCP tools for AI agents in Cursor, Claude Desktop, or any MCP client.
- Config: Set `OUTREACHAGENT_API_KEY` env var. Optional `OUTREACHAGENT_BASE_URL` (defaults to `https://api.outreachagent.dev`).
- Docs: https://outreachagent.dev/docs/mcp-server