You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs: add ClawHub badge and update README for unified skill
Add ClawHub badge linking to clawhub.ai/kevin1chun/robinhood-for-agents.
Update Skills section to reflect single unified skill with ClawHub
install instructions. Update OpenClaw setup with clawhub install option.
Remove plaintext fallback references from token storage diagram.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Robinhood for AI agents — an MCP server with 18 structured tools and a standalone TypeScript client, in a single package.
8
9
9
10
-**18 MCP tools** for any MCP-compatible AI agent
10
-
-**5 trading skills** for guided workflows (Claude Code, OpenClaw)
11
+
-**Unified trading skill** for guided workflows (Claude Code, OpenClaw, [ClawHub](https://clawhub.ai/kevin1chun/robinhood-for-agents))
11
12
-**Standalone API client** (~50 async methods) for programmatic use
12
13
13
14
Compatible with **Claude Code**, **Codex**, **OpenClaw**, and any MCP-compatible agent.
@@ -60,7 +61,7 @@ cd your-project
60
61
robinhood-for-agents install --skills
61
62
```
62
63
63
-
Restart Claude Code to pick up the changes. Claude Code supports 5 trading skills in addition to the 18 MCP tools — see [Skills](#skills-5).
64
+
Restart Claude Code to pick up the changes. Claude Code supports the unified trading skill in addition to the 18 MCP tools — see [Skill](#skill).
64
65
</details>
65
66
66
67
<details>
@@ -74,13 +75,19 @@ Restart Codex to pick up the changes. Codex uses all 18 MCP tools directly.
74
75
</details>
75
76
76
77
<details>
77
-
<summary>OpenClaw (skills only)</summary>
78
+
<summary>OpenClaw</summary>
78
79
80
+
**Via ClawHub (recommended):**
81
+
```bash
82
+
clawhub install robinhood-for-agents
83
+
```
84
+
85
+
**Via onboard CLI:**
79
86
```bash
80
87
robinhood-for-agents onboard --agent openclaw
81
88
```
82
89
83
-
This installs 5 trading skills to `~/.openclaw/workspace/skills/`. Restart the OpenClaw gateway to pick up the changes.
90
+
Both install the unified `robinhood-for-agents` skill to `~/.openclaw/workspace/skills/`. No MCP server required — the skill uses the TypeScript client API directly via `bun`.
84
91
85
92
</details>
86
93
@@ -136,26 +143,34 @@ All 18 tools work with every MCP-compatible agent.
136
143
|`robinhood_get_order_status`| Get status of a specific order by ID |
137
144
|`robinhood_search`| Search stocks or browse categories |
138
145
139
-
## Skills (5)
146
+
## Skill
147
+
148
+
A single unified skill (`robinhood-for-agents`) provides guided workflows for auth, portfolio, research, trading, and options. Available on [ClawHub](https://clawhub.ai/kevin1chun/robinhood-for-agents) and supported by **Claude Code** and **OpenClaw**.
140
149
141
-
Skills provide guided workflows on top of MCP tools. Supported by **Claude Code** and **OpenClaw**. Agents without skill support (Codex, etc.) use the 18 MCP tools directly, which provide the same functionality.
150
+
```bash
151
+
# Install via ClawHub
152
+
clawhub install robinhood-for-agents
153
+
```
142
154
143
-
|Skill | Triggers |
144
-
|-------|----------|
145
-
|`robinhood-setup`| "setup robinhood", "connect to robinhood" |
146
-
|`robinhood-portfolio`| "show my portfolio", "my holdings" |
|Setup| "setup robinhood", "connect to robinhood" |
158
+
|Portfolio| "show my portfolio", "my holdings" |
159
+
|Research| "research AAPL", "analyze TSLA" |
160
+
|Trading| "buy 10 AAPL", "sell my position" |
161
+
|Options| "show AAPL options", "SPX calls" |
150
162
151
-
Each skill includes a `client-api.md` reference for advanced users who want their agent to generate TypeScript scripts using `robinhood-for-agents`.
163
+
**Dual-mode:** The skill works with MCP tools (Claude Code) or standalone via the TypeScript client API and `bun` (OpenClaw, any agent with shell access). No MCP server required.
164
+
165
+
The skill uses progressive disclosure — `SKILL.md` is the compact router, with domain-specific files (`portfolio.md`, `trade.md`, etc.) and a full `client-api.md` reference loaded on demand.
152
166
153
167
## Agent Compatibility
154
168
155
169
| Feature | Claude Code | Codex | OpenClaw | Other MCP |
`Bun.secrets` stores tokens directly in the OS keychain — no intermediate encryption layer needed since the keychain itself provides encryption, access control, and tamper resistance. When `Bun.secrets` is unavailable (CI, headless servers), tokens fall back to a plaintext JSON file with a console warning.
305
+
`Bun.secrets` stores tokens directly in the OS keychain — no intermediate encryption layer needed since the keychain itself provides encryption, access control, and tamper resistance. There is no plaintext fallback; `Bun.secrets` is required.
294
306
295
307
Critically, **the AI agent never sees authentication tokens**. Token storage and HTTP authorization happen entirely within the MCP server process. The agent only receives structured tool results (quotes, positions, order confirmations) — never raw tokens, headers, or credentials. Even if the agent's conversation is logged or leaked, no secrets are exposed.
0 commit comments