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

# Overview

> Validate startup ideas programmatically. The Preuve Agent API lets CLIs, agents, and automations run full viability analyses and pull structured JSON.

The Preuve Agent API lets a CLI, an AI agent, an MCP client, or any automation create a Preuve analysis, poll it, generate the export-ready sections, and fetch structured `ideas-json` for downstream workflows - the same analysis engine that powers [preuve.ai](https://preuve.ai), without a browser session.

## What you can build

<CardGroup cols={2}>
  <Card title="Idea pipelines" icon="diagram-project">
    Score a backlog of startup ideas in batch (up to 10 per batch) and rank them by viability score.
  </Card>

  <Card title="Agent workflows" icon="robot">
    Let Claude, Cursor, or any MCP client validate ideas mid-conversation through the Preuve MCP
    server.
  </Card>

  <Card title="Deep diligence" icon="magnifying-glass-chart">
    Run paid deep analyses with 15+ sections, pivots, citations, and opt-in modules (Proof of
    Demand, Founder Fit, Playbook, Trends).
  </Card>

  <Card title="pSEO and research tooling" icon="database">
    Export stable, versioned JSON (`schemaVersion: 2`) built for programmatic consumption.
  </Card>
</CardGroup>

## How it works

<Steps>
  <Step title="Create a run">
    `POST /api/agent/analyses` with your idea and an explicit `scanType` (`free` or `deep`). Runs
    are async.
  </Step>

  <Step title="Poll until complete">
    `GET /api/agent/analyses/:id` until `status` is `COMPLETED` and `readyForExport` is `true`.
  </Step>

  <Step title="Enrich if needed">
    If `readyForExport` is `false`, `POST /api/agent/analyses/:id/enrich` generates the missing
    sections idempotently. Deep runs can opt into extra modules here.
  </Step>

  <Step title="Export">
    `GET /api/agent/analyses/:id/export?format=ideas-json` returns the structured result.
  </Step>
</Steps>

## Access

API keys are issued on request while the Agent API is in early access. [Request a key](https://preuve.ai/mcp#get-access) or reach out at [vincent@preuve.ai](mailto:vincent@preuve.ai). Every request is HMAC-signed - see [Authentication](/authentication).

<Note>
  The API consumes your existing Preuve account quotas (tokens, lifetime scans, subscription scans).
  There is no separate API billing. See [Quotas and billing](/quotas-and-billing).
</Note>