arden.← Product

DEVELOPER GUIDE / PRIVATE BETA

One API.
Your agent.

Arden’s MCP server runs locally over stdio and calls the same authenticated HTTP services as the web app. Broker credentials stay in Arden. Bring your own model or agent environment.

Connect an MCP client

  1. Contact Arden through the company LinkedIn page to request beta and repository access.
  2. Install the repository’s Python environment with uv sync.
  3. Sign in to your hosted workspace. In Developer, create a 12-hour workspace token.
  4. Configure your MCP client with the absolute repository path, hosted application origin, and token below.
{
  "mcpServers": {
    "arden": {
      "command": "/absolute/path/Arden/.venv/bin/python",
      "args": ["-m", "arden.mcp_server"],
      "env": {
        "PYTHONPATH": "/absolute/path/Arden/apps/api",
        "ARDEN_API_URL": "https://YOUR-ARDEN-APP",
        "ARDEN_API_TOKEN": "YOUR_WORKSPACE_TOKEN"
      }
    }
  }
}

The authenticated Developer page generates the URL for your current installation. This is a local stdio adapter, not a hosted remote MCP transport. There is no published Arden SDK package to install.

Capabilities

ClassActual toolsBehavior
READarden_list_strategies
arden_get_market_data
arden_get_backtest
arden_compare_backtests
arden_get_portfolio
arden_get_deployments
arden_get_risk_limits
arden_get_audit_events
arden_replay_paper_decision
Inspect workspace evidence and replay saved risk decisions. Alpaca history requires a configured connection.
DRY RUNarden_propose_paper_orderReturn the current decision and Safe Envelope: the largest whole-share quantity approved at that snapshot, next-share constraint, and projected portfolio effects. No reservation or submission.
COMPUTEarden_run_backtestPersist a deterministic hypothetical research run. Synchronous in this beta.
WRITE / OPT INarden_submit_paper_order
arden_cancel_paper_order
Set ARDEN_MCP_ALLOW_WRITES=true in the client environment to expose these tools.

Authentication and revocation

Tokens are scoped to one workspace, stored as hashes, and expire after 12 hours. They currently grant the same workspace authority as the signed-in owner. READ / COMPUTE / WRITE are MCP tool classifications and client exposure controls, not separate API permission scopes. Share tokens only with trusted clients.

Revoke a specific token by sending POST /api/v1/auth/logout with its Bearer token and no browser cookie. A browser sign-out revokes that browser session; it does not revoke separately issued tokens.

Use HTTP directly

import os
import httpx

with httpx.Client(
    base_url=os.environ["ARDEN_API_URL"] + "/api/v1",
    headers={"Authorization": "Bearer " + os.environ["ARDEN_API_TOKEN"]},
    timeout=60,
) as arden:
    response = arden.get("/strategies")
    response.raise_for_status()
    print(response.json())

Read the authenticated OpenAPI schema at /api/v1/openapi.json on your application origin. The API proxy never injects an operator token.

Safe Envelope and Decision Replay

POST /api/v1/orders/propose is an authenticated, workspace-scoped dry run. Supply deployment_id, symbol, side, whole-share quantity, and client_order_id. The response includes the normal risk decision, receipt_id, and safe_envelope with max_quantity, binding_constraints, estimated notional, remaining cash, and projected position/gross exposure when a quantity passes. It is a current-snapshot preview; capital is not reserved and PAPER execution is rechecked.

POST /api/v1/orders/propose
{
  "deployment_id": "YOUR_DEPLOYMENT_ID",
  "symbol": "AAPL",
  "side": "buy",
  "quantity": 1000,
  "client_order_id": "YOUR_UNIQUE_DRY_RUN_ID"
}

GET /api/v1/orders/{order_id}/decision-replay?stage=proposal
GET /api/v1/orders/{order_id}/decision-replay?stage=fill

Replay reads the saved order in your workspace and recomputes the selected proposal or fill decision from its stored intent, portfolio, prices, policy, and engine version. EXACT_MATCH compares the original and recomputed results; DRIFT_DETECTED lists changed fields. Older decisions without context or unavailable engine versions return UNAVAILABLE. Replay never submits an order or consults current market prices.

Local stdio MCP exposes the same services as arden_propose_paper_order(deployment_id, symbol, side, quantity, client_order_id) and arden_replay_paper_decision(order_id, stage="proposal"). These are available without enabling optional PAPER write tools. The public synthetic proof artifact contains a saved rejection, its Safe Envelope preview, and the replay result.

The execution boundary

Authentication → workspace ownership → application service → OrderService → deterministic risk checks → PAPER broker. Orders retain stable client IDs; ambiguous broker outcomes are reconciled rather than blindly retried. Stop and kill do not guarantee cancellation before a racing fill.

Current operating limits

Trusted repository strategy modules only. Synthetic research and Alpaca IEX daily bars. Mock Paper replay and Alpaca PAPER execution. One dedicated external paper account/deployment per workspace. Research is synchronous. No live-money execution, hosted model inference, MFA, self-service recovery, or granular team roles.

Connect with Arden ↗