Skip to content

Quickstart

Get from API key to first parse quickly, then decide whether your product should stay on REST or move into MCP.

  1. Get an API key

    Sign up in the developer portal and generate a key at portfoliointel.co.in/developers — or, from an agent or a script, register one with a single call:

    Terminal window
    curl -s -X POST https://api.portfoliointel.co.in/api/v1/register
    PrefixEnvironmentNotes
    sk_test_*TestFree credit allowance; parses real PDFs and the sandbox samples.
    sk_live_*ProductionReal parsing, billing, and operational limits apply.
  2. Parse your first CAS

    Terminal window
    curl -X POST https://api.portfoliointel.co.in/api/v1/parse \
    -H "X-API-Key: sk_test_your_key" \
    -F "file=@cas.pdf"
  3. Read the response shape

    {
    "success": true,
    "data": {
    "snapshot_id": "snap_abc123",
    "investor_name": "ADITYA SHARMA",
    "as_of_date": "2024-12-31",
    "source": "CAMS",
    "statement_type": "DETAILED",
    "total_value": 1250000,
    "folio_count": 3,
    "mutual_funds": [
    {
    "name": "Axis Bluechip Fund - Direct Growth",
    "isin": "INF846K01EW2",
    "units": 500.123,
    "nav": 52.34,
    "value": 26174.44
    }
    ],
    "confidence": { "document": 0.95, "level": "HIGH" }
    }
    }
  4. Decide the right integration surface

    • Use the REST API if your product already owns the workflow and just needs structured CAS output.
    • Use MCP if your users work inside Claude, Cursor, Copilot, or another MCP-capable client.
    • Use the browser tool when you want the most privacy-preserving individual-investor experience.