Tools

77 MCP tools across all FundOS modules. Every tool is called the same way — the cost and permission tier differ.

Start every session with fundos_get_agent_context — it returns a structured briefing (pending actions, active deals, LP changes, open alerts, upcoming capital calls) for 2 credits. Read-only. Never modifies state.

Showing 77 tools

list_deal_rooms read fast 1 credit

List all deal rooms accessible to the authenticated user. Returns room IDs, names, descriptions, deal type, and status.

get_deal_room read fast 1 credit

Get full details of a specific deal room including document count, member list, folder structure, and metadata.

Required: room_id
create_deal_room write 10 credits

Create a new deal room with a name and optional description.

Required: name
list_documents read fast 1 credit

List all documents in a deal room, optionally filtered by folder. Returns file names, sizes, upload dates, and AI analysis status.

Required: room_id
get_document_metadata read fast 1 credit

Get metadata and AI analysis results for a specific document, including entity extraction, red flags, and completeness scores.

Required: room_id, doc_id
download_document read fast 1 credit

Get a short-lived, directly-downloadable URL for a document's file (PDF/XLSX/DOCX/etc.). Returns {url, filename, expires_in}. Fetch the URL to save the file to your working directory (e.g. curl -o <filename> <url>) — the URL is pre-authorized, so send NO auth header. For small text files the content is also returned inline as 'text'. The URL expires in ~10 minutes, so download promptly.

Required: room_id, doc_id
get_upload_url read fast 1 credit

STEP 1 of 2 to upload a file into a deal room. Given a room and a filename, returns a short-lived presigned PUT URL plus a document_id. Upload your file by PUTting its bytes to that url (e.g. `curl -X PUT --upload-file <localfile> "<upload_url>"`) with NO auth header — the URL is pre-authorized. Then call confirm_upload with the returned document_id to finalize it. The URL expires in ~10 minutes.

Required: room_id, filename
confirm_upload read fast 1 credit

STEP 2 of 2 to upload a file. Call this AFTER you have PUT the file bytes to the upload_url from get_upload_url. Finalizes the document so it appears in the deal room (and extracts its text for search). Pass the document_id you got from get_upload_url.

Required: room_id, document_id
list_folders read fast 1 credit

List the folder tree of a deal room. Returns {root_folder_id, folders:[{id, name, parent_id, depth, doc_count}]}. Use this to find a folder_id before creating/renaming/deleting or uploading into a folder.

Required: room_id
create_folder read fast 1 credit

Create a folder in a deal room. Optionally nest it under a parent folder (parent_id from list_folders); defaults to the room root. Returns the created folder {id, name, parent_id}.

Required: room_id, name
rename_folder read fast 1 credit

Rename a folder and/or move it under a different parent. Provide `name` to rename and/or `parent_id` to re-parent. Cannot rename/move the room root. Requires manager access.

Required: room_id, folder_id
search_documents read fast 1 credit

AI-powered semantic search across documents. Returns relevant excerpts with citations to the exact document and clause.

Required: query
list_room_members read fast 1 credit

List all members of a deal room with their roles and access permissions.

Required: room_id
invite_member write 10 credits

Invite a user to a deal room by email with a specified access role.

Required: room_id, email, role
list_users read fast 1 credit

List all users in the organization with their roles and status.

get_audit_log read fast 1 credit

Retrieve audit log entries for a deal room showing who accessed what documents, when, and from which IP address.

Required: room_id
get_document_activity read fast 1 credit

Get document activity analytics for a room: view counts, unique viewers, time spent per document, and download counts.

Required: room_id
list_qa_questions read fast 1 credit

List Q&A questions for a deal room, optionally filtered by status.

Required: room_id
answer_qa_question write 10 credits

Post an answer to an open Q&A question in a deal room.

Required: room_id, question_id, answer
get_intelligence_report ai light 25 credits

Retrieve an AI intelligence analysis report for a deal room. Reports include: entity_map (companies, people, valuations, dates), red_flags (risky clauses, missing reps), completeness (checklist score), summary (narrative deal summary), benchmarking (vs. market), compliance (FCPA/GDPR/sanctions), negotiation (leverage points), qa_prep (anticipated buyer questions).

Required: room_id
fundos_vdr_analyze ai light 25 credits

Analyze a bundle of VDR documents for red flags, entity map (companies, people, valuations, dates), and risk summary. Accepts inline docs or MCP BYOD source. Returns red_flags[] and entity_map. Costs 25 credits. Pass summary=true for a 3-sentence Gemini compression at 5 credits instead.

Required: source
fundos_generate_odd ai light 25 credits

Draft ODD/DDQ answers from fund source documents. Source can be inline documents or an MCP BYOD source (connection_id + path). Returns structured answers per topic. Costs 25 credits. Pass summary=true for a 3-sentence summary at 5 credits.

Required: source
fundos_generate_cim ai heavy 50 credits

Draft a Confidential Information Memorandum from source documents. Sections depend on template_key. Costs 50 credits. Pass summary=true for a 3-sentence Gemini summary at 5 credits instead.

Required: source
fundos_get_similar_runs read fast 1 credit

Query the FundOS reasoning library for historically similar agent runs. Given a task description, returns past runs that used similar tool sequences with their outcome summaries and credit costs. Call this before complex multi-tool workflows to see how analogous tasks were handled before. Costs 1 credit.

Required: task_description
fundos_get_agent_context read multi 2 credits

Return a structured session briefing for this agent: recent tool calls, pending human-approval actions, active deals, LP roster, open risk alerts, upcoming capital calls, recently uploaded documents, and prior agent runs. Call this at the start of any multi-step FundOS workflow to orient yourself before taking further actions. Costs 2 credits.

research_list_templates read fast 1 credit

List the research report templates available to this organisation — structured outlines the analyst agent fills section-by-section (e.g. 'Investment Memo', 'ODD'). Returns {template_id, name, description}. Pick a template_id for research_generate_report, or create one with research_create_template.

research_create_template read fast 1 credit

Create a bring-your-own research template: an ordered list of sections, each with `instructions` for what the analyst must cover and an optional `word_budget`. Returns {template_id}.

Required: name, sections
research_add_sources read fast 1 credit

Give the analyst agent documents to read before generating. Sources can be Kela VDR documents already in the org (`source_document_ids` from list_documents/search_documents), a public `source_url`, or pasted `source_text`. Omit `thread_id` to start a new research thread; reuse the returned thread_id to add more. Returns {thread_id, ingested:[...]}.

research_generate_report read fast 1 credit

Kick off a full report run for a template + research thread. Asynchronous — returns {mapping_id, status:'queued'} immediately; poll research_report_status until 'done', then research_get_report. Set `preview` true for a fast partial run.

Required: template_id, thread_id
research_report_status read fast 1 credit

Poll a report started by research_generate_report. Returns {mapping_id, status, sections_done, sections_total}; status is 'queued'|'running'|'done'|'error'. Poll every ~10-20s; full reports take a few minutes.

Required: mapping_id
research_get_report read fast 1 credit

Retrieve a finished report (status 'done'). `format` = 'markdown' (default, full text with citations) or 'pdf' (download URL). Returns the report content.

Required: mapping_id
vi_list_firms read fast 1 credit

List the VentureInsights firms/funds your account owns. Read-only. Call this FIRST if the user might manage more than one firm: if it returns a single firm, just use it (pass nothing); if it returns several, ask the user which firm/fund they want to work on this session, then pass that `vcFirmId` on every subsequent vi_* CRM call. Returns [{vcFirmId, name}].

vi_list_emails read fast 1 credit

Search/browse the firm's email inbox across BOTH stores: LP + investment-update mail ('crm') and deal-pipeline forwards ('pipeline'). Returns slim INDEX rows (subject, sender, date, lp/deal tag, ~200-char snippet, attachment names, source) — use vi_get_email with an id + source to read a full email. Read-only, newest first.

vi_get_email read fast 1 credit

Read ONE email in full — complete untruncated plain-text body plus attachment metadata. Use the id and source from a vi_list_emails row. Read-only.

Required: email_id
vi_list_deals read fast 1 credit

List the org's VentureInsights deal-pipeline deals. Read-only. Optional filters: dealStatus, dealStage, search, ycBatch, fundId, page, take. Firm scope is resolved from your workspace identity — you never pass it. Returns the deal list + pagination.

vi_create_deal read fast 1 credit

Create or update a deal in the VentureInsights pipeline. WRITE — persists to VI. Required: `companyName`, `dealStatus`, and `vcFundId` (the fund the deal belongs to — get it from the user or the firm's funds). Firm scope comes from your workspace identity (pass `vcFirmId` only if the user manages multiple firms).

Required: vcFundId, companyName, dealStatus
vi_move_deal_stage read fast 1 credit

Move one or more deals to a new pipeline stage (bulk). WRITE. Pass `dealIds` (array) and the target `dealStage`. Firm scope is from identity.

Required: dealIds, dealStage
vi_list_lp_prospects read fast 1 credit

List the org's LP CRM prospects. Read-only. Optional filters passed through as query params (e.g. stage, search, page, take). Firm scope is resolved from your workspace identity.

vi_create_lp_prospect read fast 1 credit

Create an LP prospect in the VentureInsights LP CRM. WRITE. `dealName` (the LP/prospect name) is required. Firm scope comes from identity.

Required: dealName
vi_update_lp_prospect read fast 1 credit

Update an existing LP prospect's fields. WRITE. Pass the prospect `id` plus the fields to change. Firm scope comes from identity.

Required: id
vi_move_lp_stage read fast 1 credit

Move an LP prospect to a new fundraising stage. WRITE. Pass the prospect `id` and target `stage`. Firm scope comes from identity.

Required: id, stage
vi_add_crm_note read fast 1 credit

Add a note to a CRM subject (e.g. an LP prospect or deal). WRITE. Pass `subjectType` (e.g. LP_PROSPECT), `subjectId`, and `content`. Firm scope comes from identity.

Required: subjectType, subjectId, content
vi_add_crm_task read fast 1 credit

Add a task to a CRM subject (e.g. an LP prospect or deal). WRITE. Pass `subjectType`, `subjectId`, and `title`; `dueDate` optional. Firm scope comes from identity.

Required: subjectType, subjectId, title
fundos_list_deals read fast 1 credit

List the org's deal pipeline (CRM). Returns id, name, stage, counterparty, size.

fundos_get_deal read fast 1 credit

Full detail on one deal by id.

Required: deal_id
fundos_get_pipeline read fast 1 credit

Deal pipeline grouped by stage (kanban shape with counts).

fundos_list_lps read fast 1 credit

List LP investors (commitments, stage).

fundos_get_lp read fast 1 credit

Full LP detail incl. capital-call ledger.

Required: lp_id
fundos_list_covenants read fast 1 credit

All monitored covenants with current value, threshold, and status.

fundos_check_covenant read compute 5 credits

Test a covenant. Pass covenant_id + current_value to update a stored covenant (raises alerts on breach), or name/type/direction/threshold/current_value for an ephemeral check that persists nothing.

Required: current_value
fundos_list_risk_alerts read fast 1 credit

Risk alerts; open=true returns only unresolved ones.

fundos_run_pricer read compute 5 credits

Price a credit instrument: IRR/MOIC/WAL, cashflows, optional tranche waterfall. Ephemeral by default — nothing persists unless deal_id is passed with ephemeral=false.

Required: principal, term_months
fundos_compute_pnl read compute 5 credits

P&L + NAV over a date range for a fund account (read-only computation).

fundos_compute_waterfall read compute 5 credits

European waterfall LP/GP splits at exit (read-only computation).

fundos_list_fund_accounts read fast 1 credit

List fund accounts / vehicles (pick one before computing P&L).

fundos_list_facilities read fast 1 credit

Credit facilities (warehouse/ABL/sub lines) with commitment and outstanding — the leverage side of a credit fund.

fundos_run_borrowing_base read compute 5 credits

Run the borrowing base for a facility against the latest committed loan tape (or tape_id): eligibility, concentration excess, advance rates, availability. EPHEMERAL BY DEFAULT — the what-if an agent should run before proposing a draw; pass ephemeral=false to persist a run.

Required: facility_id
fundos_list_transactions read fast 1 credit

View term sheets and closings in flight; optionally filter by status.

fundos_list_syndications read fast 1 credit

View active syndications when reporting raise progress.

fundos_get_syndication read fast 1 credit

Inspect a single syndication and its allocation matrix.

fundos_list_cim_reports read fast 1 credit

List previously generated CIMs, teasers, and one-pagers.

fundos_list_cim_templates read fast 1 credit

Discover which CIM templates exist before calling fundos_generate_cim.

fundos_list_tools read fast 1 credit

Discover the full FundOS tool catalogue with parameters, tier, and cost.

fundos_hf_ops_dtcc_get_trade_status read fast 1 credit

Look up a CTM trade's live status when investigating a settlement break.

fundos_hf_ops_dtcc_list_unaffirmed read fast 1 credit

Find unaffirmed TradeSuite confirms when chasing T+0 affirmation.

fundos_hf_ops_dtcc_lookup_ssi read fast 1 credit

Fetch a counterparty's Standing Settlement Instructions via DTCC ALERT.

exceptions_list read fast 1 credit

FundOS tool.

exceptions_get read fast 1 credit

FundOS tool.

get_signature_status read fast 1 credit

FundOS vdr tool.

fundos_hf_ops_dtcc_get_affirmation_scorecard read compute 5 credits

Get the T+0 affirmation scorecard for COO/PM reporting.

fundos_create_deal write 10 credits

Add a new deal to the pipeline when an inbound pitch is qualified. Human approval required.

fundos_create_capital_call write 10 credits

Create a capital call against an LP commitment. Human approval required.

fundos_draft_transaction write 10 credits

Start a transaction record (term-sheet to closing) and seed default tasks. Human approval required.

fundos_allocate write 10 credits

Record investor allocations on a syndication. Human approval required.

fundos_add_room_member write 10 credits

Add a user to a deal room when onboarding a new collaborator or LP. Human approval required.

exceptions_update write 10 credits

FundOS tool.

fundos_call_tool ai light 25 credits

Invoke any FundOS tool by name with validated args when its schema is known.