io.github.Caplia-Tech/caplia

caplia_search

Search Caplia for companies in the caller's pipeline by name. Returns up to 25 matches with id, name, website, industry, and stage. Use this to find a company before fetching its full profile.

caplia_list_companies

List companies in the caller's pipeline. Supports cursor pagination (`cursor` from the previous response's `next_cursor`) and filtering by `stage` or by named `view`. Use `limit` (default 25, max 100) to bound the page size.

caplia_get_company

Fetch the full profile of one company by UUID: name, problem statement, industry, stage, website, founders, fundraising round, etc.

caplia_get_company_scores

Get the CRI score and per-thesis match scores for a company. Returns `{ cri: { score, scored_at, domains }, thesis_matches: [...] }`. Useful when an agent needs to reason about how a company fits the team's investment theses.

caplia_get_company_metrics

Get traction and key metrics for a company: revenue, growth, headcount, fundraising round milestones, etc.

caplia_list_company_documents

List all data-room documents attached to a company: pitch decks, financial models, founder updates, term sheets. Each entry has id, name, folder, type, size, and created_at.

caplia_get_document_url

Get a 1-hour signed download URL for a specific data-room document. The agent can fetch the bytes directly from the returned URL — file content does not pass through the API.

caplia_list_theses

List the team's active investment theses with their descriptions. Useful for an agent that's reasoning about whether a deal fits a thesis.

No parameters.

caplia_list_views

List the team's configured pipeline views (e.g. Deal Flow, My Pipeline, Screening). Each view has a key that can be used as the `view` argument on caplia_list_companies.

No parameters.

caplia_get_view_companies

Fetch the companies belonging to a named pipeline view (e.g. `deal-flow`, `my-pipeline`).

caplia_get_job

Poll the status of an async job (typically the result of a deck submission). Returns `{ status, company_id, results, errors }`. Recommended polling cadence: every 3 seconds.

caplia_submit_deck

Submit a pitch deck (PDF) to the caller's Caplia pipeline. The deck flows through the same intake pipeline as web uploads and email forwards: text extraction → company shell creation → CRI scoring → thesis matching. Returns `{ job_id, status: "queued", poll_url }` immediately; use `caplia_get_job` with the returned id to watch the company and scores land (typically 30s-2min). Requires a key with the `write` scope.