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
- Contact Arden through the company LinkedIn page to request beta and repository access.
- Install the repository’s Python environment with
uv sync. - Sign in to your hosted workspace. In Developer, create a 12-hour workspace token.
- 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
| Class | Actual tools | Behavior |
|---|---|---|
| READ | arden_list_strategies | Inspect workspace evidence and replay saved risk decisions. Alpaca history requires a configured connection. |
| DRY RUN | arden_propose_paper_order | Return 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. |
| COMPUTE | arden_run_backtest | Persist a deterministic hypothetical research run. Synchronous in this beta. |
| WRITE / OPT IN | arden_submit_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=fillReplay 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 ↗