# FirstSales Developer Documentation

> FirstSales exposes a versioned Developer API, the `firstsales` CLI, and OAuth-protected Product MCP guidance for coding agents and MCP-aware clients.

## Core documentation

- [Developer Platform overview](https://developer.firstsales.io/docs/introduction): Introduces the public Developer API, CLI, and agent surfaces.
- [Quickstart](https://developer.firstsales.io/docs/quickstart): Shows how to create a key, verify identity, and list campaigns.
- [Authentication](https://developer.firstsales.io/docs/authentication): Explains Developer API key scopes, access levels, and CLI auth order.
- [API reference](https://developer.firstsales.io/api-reference/introduction): Documents the OpenAPI-backed `/api/v1` surface.
- [CLI reference](https://developer.firstsales.io/cli-reference/introduction): Explains how to install and use the standalone `firstsales` CLI.
- [Agent workflows](https://developer.firstsales.io/agents/introduction): Explains when agents should use the API, CLI, or MCP.
- [FirstSales MCP server](https://developer.firstsales.io/agents/mcp-server): Documents OAuth, protocol behavior, consent, and the complete parity-generated released-tool catalog.

## Machine-readable authorities

- [Canonical OpenAPI YAML](https://developer.firstsales.io/openapi/firstsales-public-v1.yaml): Defines the public Developer API with OpenAPI 3.1.
- [OpenAPI JSON mirror](https://developer.firstsales.io/openapi/firstsales-public-v1.json): Provides the canonical OpenAPI contract as JSON.
- [Product release manifest](https://developer.firstsales.io/openapi/firstsales-public-v1.release-manifest.json): Records the bundle identity, authorization catalog epoch, readiness, and contract hashes.
- [Product MCP capability parity](https://developer.firstsales.io/data/capability-parity-report.v1.json): Records the exact compiled and parity-eligible MCP tool set, tenant context, bounds, and proof metadata.
- [Agent skill](https://developer.firstsales.io/skill.md): Gives agents safe operating instructions for FirstSales.

## Safety

- [API authentication](https://developer.firstsales.io/docs/authentication): Use public `/api/v1` routes and scoped credentials only.
- [MCP authorization](https://developer.firstsales.io/agents/mcp-server#authorization): Use audience-bound OAuth tokens and live tenant Grants.
- [Headless operations](https://developer.firstsales.io/docs/headless-operations): Scopes, idempotency, and error codes for headless write routes.
- [CLI commands](https://developer.firstsales.io/cli-reference/commands): Use idempotency keys for retryable writes and explicit confirmation for destructive commands.