Get started

Know if an idea is worth building before you ship. Preuve gives Cursor, Claude, or Codex a viability score, competitors, and source-linked evidence — the same analysis as preuve.ai. Paste one prompt, or run one command. Starter scans are free.

1. Get your API key

You need a paid Preuve account. Create a key at Account → API Keys. Copy the prv_... value now — it’s shown once.

export PREUVE_API_KEY=prv_...

2. Connect

One connection, then your agent can score ideas in the chat. Paste the prompt, or copy the command. Keep the key out of the chat.

Paste this as-is. The agent will tell you where to put the key.

I want to validate startup ideas with Preuve: viability score, competitors, source-linked evidence.

Add the Preuve MCP server.

1. I have a Preuve API key (prv_...) from https://preuve.ai/app?settings=apiKeys.
   Do NOT ask me to paste the key into chat — put it in MCP config / env.

2. Add the remote server at https://mcp.preuve.ai/mcp (HTTP):
   - Claude Code:
     claude mcp add preuve --transport http https://mcp.preuve.ai/mcp \
       --header "Authorization: Bearer <key>"
   - Cursor / Claude Desktop — ~/.cursor/mcp.json (or Claude Desktop config):
     {
       "mcpServers": {
         "preuve": {
           "url": "https://mcp.preuve.ai/mcp",
           "headers": { "Authorization": "Bearer <key>" }
         }
       }
     }
   - Codex:
     export PREUVE_API_KEY=<key>
     codex mcp add preuve --url https://mcp.preuve.ai/mcp \
       --bearer-token-env-var PREUVE_API_KEY
   - Clients that only support stdio:
     npx -y mcp-remote https://mcp.preuve.ai/mcp \
       --header "Authorization: Bearer <key>"

3. Confirm these 7 tools appear: start_analysis, get_analysis,
   enrich_analysis, export_analysis, create_batch, get_batch, export_batch.

4. First test with scanType "starter" only (it costs nothing):
   start_analysis on my idea, poll get_analysis, show me the viability score.

Read https://docs.preuve.ai/agent-skill.md first.

claude mcp add preuve --transport http https://mcp.preuve.ai/mcp \
  --header "Authorization: Bearer $PREUVE_API_KEY"

Add this to ~/.cursor/mcp.json (or the project .cursor/mcp.json):

{
  "mcpServers": {
    "preuve": {
      "url": "https://mcp.preuve.ai/mcp",
      "headers": {
        "Authorization": "Bearer prv_..."
      }
    }
  }
}

Save the key in PREUVE_API_KEY, then:

codex mcp add preuve \
  --url https://mcp.preuve.ai/mcp \
  --bearer-token-env-var PREUVE_API_KEY

In claude.ai (web or desktop): Settings → Connectors → Add custom connector. Paste:

https://mcp.preuve.ai/mcp

Sign in with Preuve and approve. No key to copy — Preuve creates one for the connector. Revoke it anytime from API key settings.

If your client cannot use a remote HTTP MCP server, bridge with mcp-remote:

{
  "mcpServers": {
    "preuve": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.preuve.ai/mcp",
        "--header",
        "Authorization: Bearer prv_..."
      ]
    }
  }
}

Tool list and extra install options: MCP server.

3. Get a score

Ask. A starter scan is free and usually done in 1–3 minutes.

Validate this idea with a starter scan: "AI bookkeeping for solo lawyers in France"

A deep scan spends your paid quota — ask for one only when you want the full report.

Next steps

MCP tools

Score, enrich, and export an idea from the chat.

Agent Skill

Same validation, without your agent spending a paid scan by accident.

HTTP API

Same verdict, as JSON, from your own code.

Quotas

Starter is free. Deep uses the same quota as the web app.

Getting Started

For agents

Concepts

1. Get your API key

2. Connect

3. Get a score

Next steps

MCP tools

Agent Skill

HTTP API

Quotas

​1. Get your API key

​2. Connect

​3. Get a score

​Next steps

MCP tools

Agent Skill

HTTP API

Quotas

1. Get your API key

2. Connect

3. Get a score

Next steps