io.github.evidai/alpaca-guard
NPM · ALPACA-GUARD-MCP · SCANNED AUG 3
Alpaca trading API with hard daily USD cap guard. Paper trading default; live opt-in.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →
Supply Chain Security86
- No malware found by supply-chain analysis.Pass
- Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.Partial
- No install/post-install scripts declared.Pass
- Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency45
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 73 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability66
- AI-judged instruction clarity (good).Pass
- Tool/resource definitions use about 627 tokens (~78/item across 8 items; 8 tools + 0 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage90
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 70% of tool parameters carry a description.Partial
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Unverified: 1 category
A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
npm · alpaca-guard-mcp
claude mcp add evidai-alpaca-guard -- npx -y alpaca-guard-mcp
codex mcp add evidai-alpaca-guard -- npx -y alpaca-guard-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"evidai-alpaca-guard": {
"type": "local",
"command": [
"npx",
"-y",
"alpaca-guard-mcp"
],
"enabled": true
}
}
} openclaw mcp add evidai-alpaca-guard --command npx --arg -y --arg alpaca-guard-mcp
mcp_servers:
evidai-alpaca-guard:
command: "npx"
args: ["-y", "alpaca-guard-mcp"] {
"mcpServers": {
"evidai-alpaca-guard": {
"command": "npx",
"args": [
"-y",
"alpaca-guard-mcp"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 2 Aug 26 +42
- Provenance: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Schema quality: unverified → good ▲ functional
- Licence: MIT functional
- 31 Jul 26 −7
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 30 Jul 26 −18
- Malware scan: pass → unverified ▼ security
- 27 Jul 26 45
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Analysed npm/[email protected]
Provenance none
Ecosystem: npm · Outcome: none
Dependencies 94 packages
94 packages in the resolved dependency tree · 94 deprecated · 29 stale.
The dependency tree was only partially resolved, so these counts may be incomplete.
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
get_account ~30
Alpaca account snapshot (buying power, cash, equity, portfolio value, PDT flag). Read-only.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
get_latest_quote ~46
Latest bid/ask/mid quote for a given symbol from Alpaca's market-data API. Read-only.
| Name | Type | Req | Description |
|---|---|---|---|
| symbol | string | yes | e.g. AAPL, TSLA |
No output schema declared.
No examples provided.
get_positions ~35
Current open positions on Alpaca (symbol, qty, avg entry price, current price, unrealized P&L). Read-only.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
guard_set_limit ~78
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.
| Name | Type | Req | Description |
|---|---|---|---|
| dailyLimitUsd | number | yes | Non-negative USD value. Set 0 to disable trading entirely. |
No output schema declared.
No examples provided.
guard_status ~35
Return today's spend ledger: daily limit, used so far, remaining, lifetime order count, and recent 10 orders. Read-only.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
guarded_close_position ~77
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.
| Name | Type | Req | Description |
|---|---|---|---|
| qty | number | — | Optional — partial close. If omitted, closes the full position. |
| symbol | string | yes | Ticker of the position to close |
No output schema declared.
No examples provided.
guarded_place_order ~162
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? }
| Name | Type | Req | Description |
|---|---|---|---|
| limitPrice | number | — | Required if type=limit |
| qty | number | yes | Quantity in shares |
| side | string | yes | — |
| symbol | string | yes | Ticker e.g. AAPL |
| tif | string | — | — |
| type | string | — | — |
No output schema declared.
No examples provided.
setup ~36
Show alpaca-guard-mcp setup status: env vars, paper/live mode, current daily cap, and ledger file location. Read-only.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.