agentleFS
oidsdevoidsdev/honeypot/skills/robinhood-mcp/SKILL.md

robinhood-mcp

Skill0 starsChanged 21 days agoMITView on GitHub

Trade Robinhood via the official Agentic Trading MCP server (OAuth DCR + PKCE). Read balances, positions, orders; place long equity/option orders in the Agentic account.

We split this skill into the rules it gives an agent

7 rules. 0 are common, 2 are distinctive, and 5 are very specific to this project.

  • 0

    Common

    Most of the 4 edited versions we read keep these.

  • 2

    Distinctive

    This author's own choices. Worth a look.

  • 5

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Do NOT use unofficial routes (robin_stocks and similar reverse-engineer the private app API and violate the customer agreement — account …

    line 18
  2. Very specific:

    If status is not_connected, run robinhood-mcp authorize-url.

    line 71
  3. Very specific:

    After approval the browser tries to open http://127.0.0.1:18765/callback and fails — the user copies the code value from the address bar.

    line 76
  4. Very specific:

    Run robinhood-mcp status before any MCP work.

    line 88
  5. Very specific:

    Call list-tools before call-tool unless you already know the tool name and its argument shape.

    line 90
  6. Distinctive:

    Read-only exploration first: balances, positions, and order history before designing any strategy.

    line 96
  7. Distinctive:

    Every order is real money: Before placing any order, present symbol / side / quantity / order type / total cost and require the user's …

    line 99

“Common” is measured: kept by at least 6 in 10 of the 4 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Robinhood MCP

Purpose

Connect to Robinhood's official Agentic Trading MCP server (https://agent.robinhood.com/mcp/trading) — the sanctioned route for agentic trading. Reads span all Robinhood accounts (balances, positions, orders); order placement is confined to the funded Agentic account. The server supports long equities and options orders (agentic crypto was announced but not live as of late 2026).

Do NOT use unofficial routes (robin_stocks and similar reverse-engineer the private app API and violate the customer agreement — account risk).

Tooling

The MCP server is a standard JSON-RPC endpoint, so any MCP client can talk to it directly. This skill's examples use a small local wrapper CLI named robinhood-mcp — write an equivalent wrapper around your own MCP client (the subcommands below map 1:1 onto the connection flow and tool calls):

robinhood-mcp <subcommand> [options]

Connection management

robinhood-mcp status
robinhood-mcp authorize-url
robinhood-mcp exchange-code --code <code>
robinhood-mcp refresh
robinhood-mcp disconnect

MCP operations

robinhood-mcp list-tools
robinhood-mcp call-tool --name <tool> --arguments-json '<json-object>'

--arguments-json must be a JSON object; arrays or scalars are rejected. Use list-tools first to discover the tool catalogue and each tool's inputSchema. Never guess tool names.

Auth

OAuth 2.1 authorization code + PKCE S256 with Dynamic Client Registration (RFC 7591):

  • Authorization server metadata: https://agent.robinhood.com/.well-known/oauth-authorization-server
  • authorization_endpoint: https://robinhood.com/oauth
  • token_endpoint: https://api.robinhood.com/oauth2/token/
  • registration_endpoint: https://agent.robinhood.com/oauth/trading/register (open, no secret)
  • Public client (token_endpoint_auth_methods_supported: ["none"]); PKCE is what protects the exchange. Scope is fixed: internal.

Store the OAuth state (client registration + tokens) in a local file with mode 0600, e.g. ~/.config/robinhood-mcp/state.json. Tokens never leave the machine running the agent.

First-use setup flow

  1. Run robinhood-mcp status.
  2. If status is not_connected, run robinhood-mcp authorize-url. It prints an authorize_url plus step-by-step instructions.
  3. The user opens the URL in their own browser, signs in to Robinhood, and approves the connection. If the browser asks for in-app approval, they approve in the Robinhood mobile app.
  4. After approval the browser tries to open http://127.0.0.1:18765/callback and fails — the user copies the code value from the address bar.
  5. Run robinhood-mcp exchange-code --code <code>.
  6. Re-run robinhood-mcp status. When it flips to connected the output includes the server info and discovered tool catalogue.

The user needs a funded Agentic account (created in the Robinhood app under the Agentic Trading settings) before any order placement — reads work without one.

Operating Rules

  1. Run robinhood-mcp status before any MCP work. If not connected, complete the setup flow first.
  2. Call list-tools before call-tool unless you already know the tool name and its argument shape. Never guess tool names.
  3. arguments-json must be a JSON object; wrap every argument appropriately.
  4. Token refresh is automatic on expiry and on a single 401 retry. If call-tool keeps failing with 401, run robinhood-mcp refresh explicitly or ask the user to re-authorize.
  5. Read-only exploration first: balances, positions, and order history before designing any strategy. Never place an order the user's mandate does not cover.
  6. Every order is real money. Before placing any order, present symbol / side / quantity / order type / total cost and require the user's explicit confirmation. Never skip this, never batch it silently.

Also on Honeypot — a free, open index of skills for AI agents: https://honeypot-e6c.pages.dev Image: Indexed on Honeypot

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.