The fundos CLI.

Install once. Run your fund from the terminal — or wire it into any agent. Same Bearer-token auth as the REST API. 18 commands covering org admin, credits, FIX engine ops, MCP tool calls, and audit logs.

Python 3.10+ Click + httpx Read-only MCP whitelist vdr_ API key auth $0/mo to install

Mint an API key → View on GitHub

30-second quickstart

# 1. Install (editable mode — your changes apply immediately)
pip install -e ./cli

# 2. Authenticate (one-time — saves ~/.config/fundos/credentials.toml)
fundos login
  # API key (starts with vdr_):  vdr_xxxxxxxxxxxxxxxx
  # Base URL:                    https://www.kela.com

# 3. Verify
fundos whoami
  → { "email": "you@yourfund.com", "org_name": "Acme Capital", "role": "admin" }

Or skip the credentials file — export FUNDOS_API_KEY and FUNDOS_BASE_URL directly. The CLI strips an accidental Bearer prefix from your env var, so copy-pasting Bearer vdr_xxx from an API doc doesn't 401.

The command tree

org · workspace administration

fundos org list                          # every org (superadmin)
fundos org get 42                        # one org's metadata
fundos org create --name "Marbella Capital" --plan growth
fundos org enable-vertical 42 --vertical trading
fundos org cleanup-spam --apply          # bot-org cleanup, 6 safety guards

credits · AI credit ledger

fundos credits balance 42                # current balance + total used
fundos credits history 42 --limit 50
fundos credits add 42 --amount 5000 --reason "Q1 onboarding"

fix · OMS / FIX engine

fundos fix status                        # sidecar health + per-session state
fundos fix config                        # list FIXSession rows for your org
fundos fix connect --session-id 17 --active true
fundos fix send-test-order --ticker AAPL --limit-price 1.00
fundos fix fills --from 2026-05-19

db · database

fundos db status                         # connection + selected row counts
fundos db migrate                        # run inline migrations on-demand
fundos db seed 42                        # minimal demo data for an org

mcp · tool catalogue (read-only)

fundos mcp tools                         # every MCP tool + price tier
fundos mcp call fundos_list_deals        # list_*/get_*/check_* only

The CLI blocks mutating MCP tools (create_*, add_*, delete_*, …) by design — those go through the dashboards or /api/v1/* so the human-approval queue stays the single source of truth.

logs · activity feed

fundos logs audit --action cli_credit_topup
fundos logs agents --status failed --limit 20
fundos logs errors --org-id 42           # cross-org failures (superadmin)

Common operator workflows

Onboard a new hedge-fund client

fundos org create --name "Marbella Capital" --plan growth
  → { "org_id": 142, "slug": "marbella" }
fundos org enable-vertical 142 --vertical trading
fundos credits add 142 --amount 5000 --reason "Q1 onboarding bonus"
# Wire the FIX session via /fundos/oms/fix-config, then:
fundos fix connect --session-id 17 --active true
fundos fix send-test-order --ticker AAPL --limit-price 1.00

Morning FIX engine health check

fundos fix status                        # sidecar + every active session
fundos fix fills --from $(date -v-1d +%Y-%m-%d)

Top up a customer who hit the credit limit

fundos credits balance 12
fundos credits add 12 --amount 2500 --reason "Stripe webhook backlog"
fundos credits history 12 --limit 5      # confirm the topup row

Debug a failed agent run

fundos logs agents --status failed --limit 20
fundos logs errors --limit 50            # cross-org error stream
fundos logs audit --action billing_hold_refunded

For agent builders

The CLI wraps the same HTTP surface that AI agents call directly. If you're building an agent on Claude, Cursor, ChatGPT, or your own framework, you have three integration points:

MCP server

Full programmatic access — 47 tools, OAuth + Bearer auth, SSE streaming. See /mcp/info.

REST API

/api/v1/* for module-level routes, /api/cli/* for the operator surface. See /api/docs.

Discovery files

mcp.json, agents.json, tools.json, llms-full.txt.

Pricing

Tool prices are identical for humans and agents. Same call, same charge. /.well-known/tools.json publishes the full list — 48 tools × 6 tiers, 1 credit = $0.01:

Tier	Default cost	Examples
read_fast	1 cr ($0.01)	`list_deals`, `get_lp`
read_multi	2 cr ($0.02)	`get_agent_context`
read_compute	5 cr ($0.05)	`run_pricer`, `compute_waterfall`
write	10 cr ($0.10)	`create_deal` (human-approved)
ai_light	25 cr ($0.25)	`vdr_analyze`, `generate_odd`
ai_heavy	50 cr ($0.50)	`generate_cim`

Plus a flat $299/paying-seat/month for platform access, with 6,000 credits/seat included. LP and counterparty viewer seats are free. Per-client overrides negotiated separately. Benchmarked against Perplexity Finance ($200–$300/seat/mo for data + Q&A) — same price, with fund-ops workflow + 8 named agents + MCP server on top.

Try-before-you-pay

For packaged tasks (audit pack, ODD, CIM, K-1, valuation memo) Kela uses authorization-then-capture credit billing. View any AI-generated artifact for free; the charge confirms only when you download it, accept it, or feed it into another tool. Refuse or let it sit 7 days → no charge.

What the CLI cannot do (by design)

Invoke mutating MCP tools — only list_*/get_*/check_*.
Bypass the human-approval queue for agent actions.
Access another org's data (Bearer key scope is always your org).
Skip auth — there is no anonymous mode.

Environment variables

Variable	Purpose	Default
`FUNDOS_API_KEY`	Bearer token. Mint at /admin/api-keys.	—
`FUNDOS_BASE_URL`	Server to talk to.	`https://www.kela.com`

Source & issues

github.com/8vdx1/fundos-mcp — repo, issues, and changelog. PRs welcome.

Need a deeper integration walkthrough or a self-hosted Kela? Book a 30-minute call.