# HYPERneobroker.com - Full Agent Docs

The OpenRouter for financial trading. One MCP endpoint, every venue. This file is the complete integration reference for agents.

## Endpoint

- URL: https://mcp.hyperneobroker.com/mcp
- Protocol: MCP (Model Context Protocol), Streamable HTTP transport
- Auth: OAuth 2.1 + dynamic client registration (RFC 7591). Discovery:
  - https://mcp.hyperneobroker.com/.well-known/oauth-authorization-server
  - https://mcp.hyperneobroker.com/.well-known/oauth-protected-resource
- Public tools (get_price, get_perp_prices, get_prediction_markets) work without any key.
- Desk tools (get_positions, get_portfolio) require a desk key passed as a Bearer token; without one they return {locked: true}.

## Tool Reference

### get_price (public)
Market data for major tickers.
- Input: {ticker: string} - one of AAPL, TSLA, BTC, ETH, GOLD, SPX, NDX, DJI
- Output: latest price data for the ticker.

### get_perp_prices (public)
Perpetual futures prices aggregated across venues.
- Sources: Hyperliquid, trade.xyz (HIP-3 dex)
- Input: {coin?: string} - optional coin/market filter
- Output: per-venue mark prices and market context.

### get_prediction_markets (public)
Prediction markets in one normalized schema.
- Sources: Polymarket, Kalshi (Kalshi may degrade gracefully under shared-egress rate limits; responses cached 300s)
- Input: {topic?: string} - optional topic search
- Output: market title, outcomes, prices, volume, venue.

### get_positions (desk key)
Open positions on the HYPERneobroker.com paper trading desk (Alpaca paper account): ticker, qty, market value, unrealized P&L per position.

### get_portfolio (desk key)
Paper desk portfolio snapshot: equity, cash, buying power, day P&L, total P&L vs the $100k starting stack.

## Example Call (JSON-RPC)

POST https://mcp.hyperneobroker.com/mcp
Content-Type: application/json

{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_price","arguments":{"ticker":"BTC"}}}

## Connect From Major Clients

- Claude: Settings > Connectors > Add custom connector > https://mcp.hyperneobroker.com/mcp
- Claude deeplink: https://claude.ai/customize/connectors/directory?modal=add-custom-connector&connectorName=HYPERneobroker&connectorUrl=https://mcp.hyperneobroker.com/mcp
- ChatGPT: add as a custom connector with the same URL
- Grok: add the MCP URL in the connectors UI
- Cursor: add to mcp.json: {"mcpServers":{"hyperneobroker":{"url":"https://mcp.hyperneobroker.com/mcp"}}}

## Telemetry

Public usage stats: https://stats.hyperneobroker.com/ and https://stats.hyperneobroker.com/stats.json (today, week, byCountry, byCity, topClients).

## Links

- Landing: https://mcp.hyperneobroker.com/
- Privacy: https://mcp.hyperneobroker.com/privacy
- Summary: https://mcp.hyperneobroker.com/llms.txt
- Telegram: https://t.me/HYPERneobroker