Skip to content
Robber Baron

Docs

Integration.

Robber Baron exposes one MCP endpoint and a small REST API. Both require a session or an API key on every request. Create keys in the dashboard under Agent Config.

1. MCP configuration

mcp.json
{
  "mcpServers": {
    "robber-baron": {
      "url": "https://robberbaron.cc/api/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}

2. Clients

Claude Code

Either place the JSON above in .mcp.json at your project root, or register it from the CLI. Tools then appear as mcp__robber-baron__*.

shell
claude mcp add --transport http robber-baron https://robberbaron.cc/api/mcp \
  --header "Authorization: Bearer $ROBBER_BARON_API_KEY"

Cursor

Save the JSON as .cursor/mcp.json in your project or ~/.cursor/mcp.json globally, then enable robber-baron in Settings → MCP. Ask the agent to call a tool such as list_models.

Codex CLI

Add the block below, export ROBBER_BARON_API_KEY, and restart Codex. Option names follow Codex's streamable-HTTP MCP support; confirm against your installed version.

config.toml
# ~/.codex/config.toml
[mcp_servers.robber-baron]
url = "https://robberbaron.cc/api/mcp"
bearer_token_env_var = "ROBBER_BARON_API_KEY"

Generic

Any MCP client that supports Streamable HTTP: POST JSON-RPC 2.0 to the endpoint with Authorization: Bearer <key>. Methods: initialize, tools/list, tools/call, ping. Limit: 60 tool calls per minute per key.

3. Tools

get_portfolio_summary

Retrieve the current portfolio summary from the connected broker bridge (Ledger Branch).

get_positions

List current positions from the connected broker bridge (Ledger Branch).

get_buying_power

Available buying power from the connected broker bridge (Ledger Branch).

list_models

List the authenticated user's models, optionally only deployed ones.

invoke_model

Run inference against a named deployed model. Requires an inference runtime, which is not yet available; returns an explicit error until it is.

get_model_status

Check a model's status, version and deployment targets.

submit_training_job

Submit a training job to the configured backend (General Exchange research server). Only classification/regression jobs expressible as symbols + algorithms are supported today.

get_experiment_status

Poll the status of a training job / experiment.

list_datasets

List the user's datasets (uploaded and FloppyDisk-linked).

query_dataset

Query rows of one of the user's uploaded datasets by symbol, date range and columns (max 500 rows).

get_dataset_schema

Return a dataset's column schema and per-column statistics.

get_price_history

Historical OHLCV for a symbol via the FloppyDisk bridge.

get_volatility_history

Historical volatility series for a symbol via the FloppyDisk bridge.

get_correlation_matrix

Correlation matrix for a set of symbols via the FloppyDisk bridge.

get_market_regime_history

Historical market regime classifications via the FloppyDisk bridge.

analyze_portfolio

Run Robber Baron portfolio analysis on the portfolio exposed by the Ledger Branch bridge.

evaluate_trade_proposal

Score a proposed trade against the user's deployed models. Analysis only: Robber Baron never places orders.

summarize_risk

Structured risk summary for the user's portfolio (requires the Ledger Branch bridge).

Some tools depend on connected services and return an explicit error when those are not configured. Full input/output schemas are in the dashboard (Agent Config) and in tools/list.

4. REST API reference (stubs)

GET/api/v1/user/meCurrent user profile
GET / POST/api/v1/modelsList / create model records
GET / PATCH / DELETE/api/v1/models/{id}Detail / update / archive
GET / POST/api/v1/datasetsList / upload datasets
GET/api/v1/datasets/{id}Dataset detail and inspection
GET / POST/api/v1/experimentsList / submit training job
GET/api/v1/experiments/{id}Experiment detail and status
GET/api/v1/connections/statusEcosystem connection health
GET / POST/api/v1/mcpMCP SSE channel / JSON-RPC (alias: /api/mcp)
GET/api/v1/billing/usageUsage summary
GET/api/v1/billing/transactionsTransaction history

All routes accept a session cookie or Authorization: Bearer <api-key>. Detailed request/response schemas are not yet published.

5. Brokerage boundary

Connecting an AI client directly to Robinhood's MCP (https://agent.robinhood.com/mcp/trading) uses that client's own OAuth session. Robber Baron cannot proxy, limit or audit it.