# Abacus Labs > Portfolio analysis and decision API for AI agents. Ask about an account in plain English, or send a goal and/or a policy and get back broker-ready trade options with tax, risk before and after, and a proven distance from the best possible answer, checked against the account's rules. Abacus Labs does not hold assets, place orders or give investment advice. ## Start here - [Agent onboarding](https://api.abacuslabs.ai/agent.md): what Abacus Labs does, how to get a key, a complete worked example - [Docs](https://docs.abacuslabs.ai): quickstart, keys and limits, MCP setup, credits, errors, API reference - [OpenAPI](https://api.abacuslabs.ai/openapi.json): every public route and schema ## Routes - GET /agent.md: Agent onboarding note (markdown) - GET /llms.txt: llms.txt index - GET /v1/accounts: List this key's accounts: saved ones and inline ones still inside their 24 hours (inline: true, expires_at) - POST /v1/accounts: Save an account: positions with lots, cash, rules and an optional policy (or connect Alpaca) - GET /v1/accounts/{account_id}: Get an account (with its current snapshot_id and version) - PATCH /v1/accounts/{account_id}: Partial update: cash, positions, rules, history, tax_rates, name, policy - DELETE /v1/accounts/{account_id}: Delete an account - GET /v1/accounts/{account_id}/holdings: The account's holdings priced now: quantity, price, value, weight, cost basis, unrealized gain and lots per position, plus cash and total value - POST /v1/accounts/{account_id}/save: Keep an inline account: it becomes a saved account and stops expiring (a saved account comes back as it is) - POST /v1/analyze: Ask about an account in plain English; Abacus Labs runs the analyses it needs and answers with typed results (read-only) - GET /v1/benchmarks: The indexes Abacus Labs tracks (names, aliases, tickers, constituents date) and this key's saved benchmarks - POST /v1/benchmarks/resolve: Preview what a benchmark definition resolves to today (constituents, sources, staleness) without saving it - POST /v1/certificates/verify: Verify a commit certificate (no auth); the same check works offline with the JWKS key - POST /v1/commits: Commit the option the person approved: re-checked, signed certificate; requires Idempotency-Key - GET /v1/commits/{commit_id}: A commit: status committed | partially_filled | filled, its certificate and fills - POST /v1/keys: Create a sandbox key (no auth) - POST /v1/proposals: Trade options for a goal (plain English) and/or a policy: 201 with the finished proposal, or 202 + Location while it runs - GET /v1/proposals/{proposal_id}: A proposal: status running | succeeded | failed, and its options when done - POST /v1/trades/check: Check drafted trades against the account's rules; returns the verdict and the nearest legal list ## MCP - MCP server: https://mcp.abacuslabs.ai/mcp (streamable HTTP), header Authorization: Bearer (no OAuth sign-in yet); setup: https://docs.abacuslabs.ai/mcp-server; config at https://api.abacuslabs.ai/mcp.json (use its hosted entry); tools: abacus_analyze, abacus_propose, abacus_get_proposal, abacus_check_trades, abacus_commit, abacus_get_commit, abacus_create_account, abacus_get_account, abacus_patch_account, abacus_list_accounts, abacus_delete_account, abacus_get_holdings, abacus_save_account, abacus_list_benchmarks, abacus_resolve_benchmark ## Rules - Show the person the options; do not pick for them. - Place orders only after the person approves one option; apply its lot instructions at the broker. - Send every account, or save it and pass account_id; commit the chosen option so Abacus Labs remembers it. - Calls that do work cost credits (a new key: 3 portfolios, 300 credits a month); every paid response says credits_charged. Options expire after 15 minutes.