Docs/Agents/Overview

Stock market MCP server and API

Give an AI agent current, structured Stocksbrew stock intelligence. Use remote MCP with OAuth or REST with a personal token.

ProtocolMCP + REST

AuthenticationOAuth or token

AccessRead-only

PlanStocksbrew Pro

Quickstart

Connect with one prompt

Paste this into the client you want to use. It includes the server URL, OAuth, and a verification step.

Connect Stocksbrew

Copy this into your agent

Connect to Stocksbrew's remote MCP server:

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

Use OAuth and ask me to approve read-only stock access. After connecting, verify the setup by retrieving the current Stocksbrew analysis for NVDA.

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.

Uses OAuth. Your access token stays out of the conversation.

01PasteThe agent adds the server or returns manual instructions.
02ApproveSign in to Stocksbrew and approve read-only access.
03VerifyThe agent retrieves the current NVDA record.

Manual MCP setup

One remote server URL

Add https://www.stocksbrew.online/api/mcp as a remote MCP server. OAuth-capable clients will open the approval flow.

Generic MCP configuration

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

Use OAuth for interactive clients. Use a personal token for scripts or clients that require an Authorization: Bearer header.

MCP tools

Available tools

Tool	Scope	Returns
`search_stocks`	stocks:read	Find a ticker or company.
`get_stock_intelligence`	stocks:read	Get the current call, zones, target, drivers, risks, scores, and freshness.
`compare_stocks`	stocks:read	Compare two to five stocks through one contract.
`get_market_brief`	market:read	Get the current market, sector, and mover context.
`get_my_radar`	radar:read	Get the authorized member's tracked stocks.
`get_radar_changes`	radar:read	Get recent changes across the member's Radar.

REST API

Use the same contract without MCP

Create a personal token in Profile and send it as a Bearer token to https://www.stocksbrew.online/api/v1.

GET one stock

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

GET	/stocks/search?q=...	Search stocks
GET	/stocks/{symbol}	Get one stock
POST	/compare	Compare stocks
GET	/market	Get market context
GET	/radar	Get tracked stocks
GET	/radar/changes	Get tracked-stock changes

Response contract

Freshness is part of the response

Responses include the schema version, as-of time, freshness, returned data, and usage.

Example shape · values shortened

{
  "schema_version": "2026-07-20",
  "as_of": "2026-07-20T14:35:00Z",
  "freshness": {
    "status": "fresh",
    "age_hours": 0.4
  },
  "stock": { "ticker": "NVDA" },
  "call": { "directive": "..." },
  "usage": { "used": 18, "remaining": 482 }
}

Authentication & scopes

OAuth for people. Personal tokens for code.

OAuth + PKCE: For interactive clients. Stocksbrew handles sign-in, consent, and token refresh.
Personal token: For scripts and local tools. Shown once and revocable in Profile.
Scopes: stocks:read · market:read · radar:read

Limits & use

Usage and limits

Monthly allowance500 combined MCP tool calls or REST requests.
Burst limit30 calls per minute. HTTP 429 includes Retry-After.
EntitlementActive Pro is checked on every authenticated request.
Not includedBulk extraction, mirroring, resale, redistribution, trading, or account writes.