s1d3sw1ped_bot
9e711957c0
Outsiders reading this module should not see private sibling names (tradey), unfinished rewire notes, or /fast/projects lab paths. Keep the library self-contained in README, design, plan, and test fixtures/identity strings.
78 lines
2.3 KiB
Markdown
78 lines
2.3 KiB
Markdown
# robinhood-agentic-mcp
|
|
|
|
Go library for the [Robinhood Agentic MCP](https://agent.robinhood.com/mcp/trading).
|
|
|
|
**Module:** `s1d3sw1ped/robinhood-agentic-mcp`
|
|
**Go:** 1.25
|
|
**Default MCP URL:** `https://agent.robinhood.com/mcp/trading` (`rh.DefaultURL`)
|
|
|
|
This moves **real money** in a Robinhood Agentic account. Not investment advice. The caller is responsible for every fill.
|
|
|
|
There is no CLI. `Login` is a library function.
|
|
|
|
## Identity
|
|
|
|
Set `Config.Name` and `Config.Version` **before** `Login` or `Connect`. They are the MCP `Implementation` name/version and the OAuth client name. After a session exists they cannot be changed.
|
|
|
|
Empty `Name` / `Version` / `URL` become `robinhood-agentic-mcp` / `0.1.0` / `rh.DefaultURL`. Apps that need a distinct Robinhood OAuth client pass their own `Name`.
|
|
|
|
```go
|
|
cfg := rh.Config{
|
|
TokenFile: "tokens.json",
|
|
Name: "my-bot", // MCP identity and OAuth ClientName
|
|
Version: "0.1.0",
|
|
}
|
|
```
|
|
|
|
Daemon/headless callers must not call `Login` (no browser). They call `Connect` with an existing token file (mode `0600`).
|
|
|
|
## Example
|
|
|
|
```go
|
|
package main
|
|
|
|
import (
|
|
"context"
|
|
"log"
|
|
|
|
decimal "github.com/alpacahq/alpacadecimal"
|
|
rh "s1d3sw1ped/robinhood-agentic-mcp"
|
|
"s1d3sw1ped/robinhood-agentic-mcp/equity"
|
|
)
|
|
|
|
func main() {
|
|
ctx := context.Background()
|
|
cfg := rh.Config{
|
|
TokenFile: "tokens.json",
|
|
Name: "my-bot",
|
|
}
|
|
|
|
if _, err := rh.Login(ctx, cfg); err != nil {
|
|
log.Fatal(err)
|
|
}
|
|
|
|
api, err := rh.Connect(ctx, cfg)
|
|
if err != nil {
|
|
log.Fatal(err)
|
|
}
|
|
|
|
qty := decimal.RequireFromString("1")
|
|
limit := decimal.RequireFromString("100")
|
|
_, err = api.Equity.PlaceOrder(ctx, equity.PlaceOrderRequest{
|
|
Symbol: "MU",
|
|
Side: rh.Buy,
|
|
Type: rh.Limit,
|
|
Qty: &qty,
|
|
LimitPrice: &limit,
|
|
TimeInForce: rh.GFD,
|
|
})
|
|
if err != nil {
|
|
log.Fatal(err)
|
|
}
|
|
}
|
|
```
|
|
|
|
`Login` writes tokens when `ROBINHOOD_ACCESS_TOKEN` is set, otherwise it runs a browser OAuth dance. `Connect` opens a streamable MCP session as `cfg.Name`/`cfg.Version`, or falls back to JSON-RPC `tools/call` with a bearer token.
|
|
|
|
Subpackages (`accounts`, `equity`, `options`, `crypto`, `watchlists`, `market`, `scanner`) also export `New(c client.Caller) *Client` for use without the facade. `api.Client.Call` is the escape hatch for any MCP tool by name.
|