alpaca-guard-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ALPACA_API_KEY | Yes | From Alpaca dashboard | |
| ALPACA_SECRET_KEY | Yes | From Alpaca dashboard | |
| ALPACA_PAPER_TRADE | No | Set to 'false' for live trading (still requires ALPACA_GUARD_ALLOW_LIVE) | true |
| LEMON_CAKE_PAY_TOKEN | No | Currently unused (v0.1 local-ledger mode). Future: switch the guard to LemonCake's Pay Token preflight. | |
| ALPACA_GUARD_ALLOW_LIVE | No | Must literally be 'yes-i-understand' to enable real-money orders | |
| ALPACA_GUARD_LEDGER_DIR | No | Where cap.json lives | ~/.alpaca-guard |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {} |
| logging | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| setupA | Show alpaca-guard-mcp setup status: env vars, paper/live mode, current daily cap, and ledger file location. Read-only. |
| guard_statusA | Return today's spend ledger: daily limit, used so far, remaining, lifetime order count, and recent 10 orders. Read-only. |
| guard_set_limitA | Set the daily USD cap. The agent cannot raise its own cap silently — calling this tool is logged in the ledger. Typical use: human operator runs this once to set the daily limit (default $10) before letting the agent loose. |
| get_accountA | Alpaca account snapshot (buying power, cash, equity, portfolio value, PDT flag). Read-only. |
| get_positionsA | Current open positions on Alpaca (symbol, qty, avg entry price, current price, unrealized P&L). Read-only. |
| get_latest_quoteB | Latest bid/ask/mid quote for a given symbol from Alpaca's market-data API. Read-only. |
| guarded_place_orderA | Place an order on Alpaca, but ONLY if the trade's notional USD value fits within today's remaining cap. Pre-flight is mandatory: agent cannot override. If notional > remaining, returns BUDGET_EXCEEDED with a structured hint. On success the charge is recorded to the local ledger so the cap survives MCP restarts. Returns: { allowed, status, tradeNotionalUsd, remainingUsd, limitUsd, alpacaOrder?, x402Receipt? } |
| guarded_close_positionA | Close a position on Alpaca. Pre-flighted against the daily cap: if closing requires re-opening exposure (short close → re-buy) that exceeds the cap, refuses. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/evidai/agent-payment-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server