> ## Documentation Index
> Fetch the complete documentation index at: https://developer.firstsales.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent workflows

> Use FirstSales from Codex, Claude Code, Gemini, Claude.ai, and MCP-aware tools.

Agents can use two public FirstSales surfaces:

* Developer API for any tool that can send HTTPS requests.
* `firstsales` CLI for local shells, coding agents, CI, and scripts.

Agents should prefer the CLI when shell access exists because it centralizes auth, JSON output, idempotency headers, and destructive confirmation behavior.

When shell access does not exist, use the API examples directly.

## MCP

The MCP integration guide is available at
[FirstSales MCP server](https://developer.firstsales.io/agents/mcp-server).
It documents the Product MCP resource, the modern `2026-07-28` and legacy
`2025-11-25` contracts, and the OAuth grant model. The synchronized release manifest
has `release_ready: true`. The current released tool catalog is read-only; no
approval-backed Product MCP action is released. The MCP guide renders its
complete tool list from the machine-owned parity artifact.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.