Stock research, Watchlist and alerts for your agent

Quickstart

Connect with one prompt

Paste this into your agent. It includes OAuth, safe confirmation rules, and a verification task.

Connect to Stocksbrew's remote MCP server:

https://www.stocksbrew.online/api/mcp

Use OAuth. After connecting, verify the setup by showing my Watchlist and its latest changes.

When I ask about a stock, call get_stock_intelligence first. If the detailed brief is missing, explain what data is available and ask before using add_to_radar to queue or refresh research. Recheck the stock later when research is queued or running.

You may read my Watchlist and alerts. Ask for my confirmation before adding or removing a Watchlist stock, or creating or deleting a price alert. Use get_radar_changes for earnings, RSI, call, anomaly and news updates. Never place trades or claim Stocksbrew can access a brokerage.

If you cannot add the server automatically, give me the exact setup steps for this client. Never ask me to paste an access token into chat.

1. 1. Connect. Add https://www.stocksbrew.online/api/mcp as a remote MCP server.
2. 2. Approve. Sign in and choose only the permissions the agent needs.
3. 3. Verify. Ask: “Show my Watchlist and explain anything that changed today.”

Client setup

Claude Code, Hermes, OpenClaw, and REST

OAuth-capable clients open the Stocksbrew approval screen. Reconnect an older client if it needs Watchlist or alert write scopes.

claude mcp add --transport http stocksbrew https://www.stocksbrew.online/api/mcp

{
  "mcpServers": {
    "stocksbrew": { "url": "https://www.stocksbrew.online/api/mcp", "auth": "oauth" }
  }
}

openclaw mcp add stocksbrew --url https://www.stocksbrew.online/api/mcp --auth oauth
openclaw mcp login stocksbrew
openclaw mcp doctor stocksbrew --probe

curl -H "Authorization: Bearer $STOCKSBREW_TOKEN" \
  "https://www.stocksbrew.online/api/v1/stocks/NVDA"

Common recipes

The jobs agents can do

{
  "instrument": { "ticker": "CCL", "name": "Carnival" },
  "market_data": { "price": 27.81 },
  "coverage": {
    "status": "baseline_only",
    "tracked_in_radar": false,
    "has_baseline_data": true,
    "has_detailed_call": false,
    "next_action": {
      "action": "ask_to_add_to_radar",
      "tool": "add_to_radar"
    }
  }
}

POST https://www.stocksbrew.online/api/v1/alerts
Authorization: Bearer $STOCKSBREW_TOKEN
Content-Type: application/json

{
  "ticker": "NVDA",
  "kind": "price_threshold",
  "condition": "below",
  "target_price": 190
}

Chat delivery

Telegram, WhatsApp, and Discord

Hermes or OpenClaw owns the chat connection and schedule. Stocksbrew supplies research and Watchlist changes. Ask your agent to poll changes, message only when something important changed and retain the cursor after a successful send.

Check my Stocksbrew Watchlist every morning.
Message me only when earnings, a directive, a risk, or a tracked price level changed.
Keep the returned cursor for the next check.

MCP reference

Eleven explicit tools

REST reference

The same workflow without MCP

Every path is under https://www.stocksbrew.online/api/v1.

Coverage states

Missing research stays explicit

Agents should treat coverage.status as factual and coverage.next_action as the recovery instruction.

ready · queued · running · baseline_only · no_sources · failed · unavailable

Authentication and scopes

Grant the smallest useful permission set

Research

stocks:read · market:read

Watchlist companion

+ radar:read

Full assistant

+ radar:write · alerts:read · alerts:write

Mutating tools are marked as writes. Clients should confirm before calling them. Remove and delete operations are also marked destructive.

Errors and limits

Predictable failure behavior

• Allowance: 500 MCP or REST calls per month.
• Burst: 30 calls per minute. HTTP 429 includes Retry-After.
• Errors: stock_not_found, invalid_alert_kind, profile_not_ready, forbidden_scope, subscription_required, rate_limited.
• Excluded: trading, brokerage access, bulk extraction, resale, and redistribution.