robinhood-mcp: Instructions file for Claude Code

CLAUDE.md

robinhood-mcp CLAUDE.md is an instructions file for Claude Code from drasticstatic/robinhood-mcp. It costs 1,958 tokens per session, scanned A, original, MIT.

A project guide for robinhood-mcp, a read-only server that exposes Robinhood portfolio research through tools. It documents the Python layout, delayed login, error handling, and commands for linting, formatting, and tests.

In plain words
What is it for?
Use it when developing, reviewing, testing, or troubleshooting robinhood-mcp and its authentication, tool, and server code.
Why use it?
It makes the project’s safety boundary clear: the server can read portfolio data but cannot place, cancel, or modify trades. It also gives coding agents the conventions and checks needed for changes.

Instructions file for Claude Code

Written for Claude Code: the file is CLAUDE.md. Also seen: reads .claude/ paths; mentions CLAUDE.md; mentions Claude Code.

This is drasticstatic/robinhood-mcp's own configuration. It tells Claude Code how to work on robinhood-mcp itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything robinhood-mcp configures →

Reuse

Borrowing it

Nothing to install: this file belongs to drasticstatic/robinhood-mcp. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/drasticstatic/robinhood-mcp/main/CLAUDE.md
Clone the repo
git clone --depth 1 https://github.com/drasticstatic/robinhood-mcp

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for robinhood-mcp CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/drasticstatic/robinhood-mcp/claude-md/github.svg)](https://agentmods.dev/instructions/drasticstatic/robinhood-mcp/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/drasticstatic/robinhood-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/drasticstatic/robinhood-mcp/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for robinhood-mcp CLAUDE.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/drasticstatic/robinhood-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/drasticstatic/robinhood-mcp/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 1,958 This file is loaded in full into every session.
When invoked 1,958 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.01958 $0.01958
Opus 5.5 $0.00783 $0.00783
Sonnet 5.5 $0.00392 $0.00392
Haiku 4.5 $0.00196 $0.00196

Measured today against content hash e7282ee030cd, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

robinhood-mcp CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 184 lines

How it starts

The opening of the file, as written. The whole thing — 184 lines — stays where its author put it; the contents beside it link to each section on GitHub.

CLAUDE.md

This file provides guidance to Claude Code when working with this repository.

⚠ FIRST: sync this clone before you touch anything

git pull --rebase --autostash

Run this at the start of every session, before reading deeply or editing. Several agents and Christopher push to these repos — including Cosmos agents that run unattended while nobody is at the machine — so a clone can be behind by the time you open it.

--autostash is what makes this safe on a dirty tree. It stashes uncommitted changes, rebases onto the remote, then reapplies them. Your in-progress work survives. Without it, git pull --rebase refuses to run and you are tempted into something worse.

Why it matters more than it sounds:

  • A stale clone does not fail early. It fails at push time, after the work is done, as a non-fast-forward rejection — the most expensive moment to discover it.
  • The tempting fix at that point is git push --force, which discards whatever someone else pushed in the meantime. Syncing first removes the temptation.
  • If a rebase does conflict, stop and resolve it deliberately. A conflict is information: someone else changed the same lines, and you want to know that before building on top of them.

Fresh clone? Also run sh scripts/install-hooks.sh — git hooks are not version-controlled, so the commit-attribution hook stays inert until this clone is pointed at .githooks/. Details: scripts/README.md.


Project Overview

robinhood-mcp is a read-only MCP server that wraps the robin_stocks Python library to provide research tools for Robinhood portfolio data. This is strictly a research/educational tool - no trading functionality is exposed.

Architecture

src/robinhood_mcp/
├── __init__.py      # Package version
├── auth.py          # Authentication with TOTP support
├── tools.py         # 12 read-only tool implementations
└── server.py        # FastMCP server with tool registration

Read the full file on GitHub · 184 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. today Changed · +10 lines · +187 tokens per session e7282ee030cd
  2. 1mo ago Changed · +58 lines · +755 tokens per session 0d8fa93118e2
  3. 2mo ago First seen · 116 lines · 1,016 tokens per session scan A 7a7576c397cc

Subscribe to this mod's changes

robinhood-mcp CLAUDE.md is an instructions file published in the GitHub repository drasticstatic/robinhood-mcp (0 stars, last pushed today), licensed MIT. It adds 1,958 tokens to every session, about $0.0078 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

robinhood-mcp CLAUDE.md compared with instructions from other repositories

robinhood-mcp CLAUDE.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
robinhood-mcp CLAUDE.mddrasticstatic/robinhood-mcpInstructions file0todayMITA1,958Claude Code
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143ktodayMITA7,461Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA5,649GitHub Copilot
langchain AGENTS.mdlangchain-ai/langchainInstructions file149ktodayMITA4,680Codex, OpenCode
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA3,093GitHub Copilot
vscode model-prompts.instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA2,022GitHub Copilot