llms.txt
Compare with other sites' llms.txt files →# PolyBridge API
PolyBridge provides read-only Search, Forecast, and approved RVOL data over REST, plus MCPB tools for agent clients.
For complete agent-readable context, use `https://polybridge.ai/llms-full.txt`.
## Public REST
- Health: `GET https://api.polybridge.ai/v1/health`
- Search: `POST https://api.polybridge.ai/v1/search`
- Forecast: `POST https://api.polybridge.ai/v1/forecast`
- RVOL models: `GET https://api.polybridge.ai/v1/rvol/models`
- RVOL assets: `GET https://api.polybridge.ai/v1/rvol/assets`
- RVOL latest forecasts: `GET https://api.polybridge.ai/v1/rvol/latest`
- RVOL forecast history: `GET https://api.polybridge.ai/v1/rvol/history`
- RVOL actuals: `GET https://api.polybridge.ai/v1/rvol/actuals`
- RVOL latest feature summaries: `GET https://api.polybridge.ai/v1/rvol/features/latest`
- OpenAPI: `GET https://api.polybridge.ai/openapi-public.json`
The OpenAPI file describes REST shapes. Use the public docs for current auth and limit behavior.
## Auth
- Search supports anonymous access and Bearer API keys.
- Forecast supports anonymous access and Bearer API keys.
- Authenticated Search requires `search:read`.
- Authenticated Forecast uses `forecast:read`.
- RVOL requires Bearer API keys with `rvol:read`.
- Approved accounts receive `rvol:read` on eligible keys. Other keys can use Search and Forecast, but RVOL returns `403`.
- Invalid or malformed auth fails and does not fall back to anonymous access.
- Do not expose long-lived API keys in browser clients.
## Forecast limits
Anonymous Forecast: 10/minute per subject, 50/day per subject, 2 in-flight per subject.
API-key Forecast: 60/minute, 500/day per authenticated API-key consumer, 5 in-flight per consumer.
Hosted MCP works without a key at anonymous limits. Add an API key or supported OAuth for higher usage.
## RVOL schema
RVOL is available through REST endpoints and approved MCPB tools.
RVOL returns model identifiers and versions, asset coverage, forecast values, realized actuals, and public feature-family categories.
External approved RVOL access is protected by app-level abuse-prevention limits. Contact PolyBridge for higher limits.
RVOL output is not trading advice, not order execution, and not investment advice.
## Search schema
REST Search inputs: `query`, optional `dimensions`, optional `top_k_per_dimension`, optional `filters.status`.
Search returns results grouped by dimension. Search scores are relevance/ranking values, not probabilities.
## Forecast schema
REST Forecast inputs: `question`, optional `include_graph`. Set `include_graph=false` for a smaller response with `causal_graph: null`.
Forecast returns `probability`, confidence, uncertainty, reasoning, and supporting market evidence when available. Forecast output is read-only information, not trading instructions or financial advice.
## MCP
Hosted MCP:
- URL: `https://mcp.polybridge.ai/mcp`
- Transport: Streamable HTTP
- Auth: none, Bearer API key, or supported Hosted MCP OAuth
- Tools: `polybridge_search`, `polybridge_forecast`
- PolyBridge MCP is read-only. It does not trade or move funds.
Local MCPB:
- Transport: stdio
- Package/script: `polybridge-mcp-server`
- Repo: `https://github.com/crowdvector/polybridge-mcp`
- Local auth: none for Search and Forecast at anonymous limits; `POLYBRIDGE_API_KEY` for higher usage or approved RVOL tools
- MCPB version: `0.3.1`
- Release: `https://github.com/crowdvector/polybridge-mcp/releases/tag/polybridge-mcp-v0.3.1`
- RVOL tools require `POLYBRIDGE_API_KEY` with `rvol:read`.
## Agent workflows
AI Agent Hub provides copy-ready workflow prompts.
Hosted MCP is the connection layer. AI Agent Hub is the workflow layer.
- AI Agent Hub: `https://polybridge.ai/api/agents`
- Connect Hosted MCP: `https://polybridge.ai/api/agents/connect`
- Mortgage rates workflow: `https://polybridge.ai/api/agents/mortgage-rates`
- Market map workflow: `https://polybridge.ai/api/agents/market-map`
- Market stress brief: `https://polybridge.ai/api/agents/vix-stress`
- Pre-trade check workflow: `https://polybridge.ai/api/agents/pre-trade-check`
- Agent-readable files: `https://polybridge.ai/api/agents/files`
- AI Agent Hub Markdown: `https://polybridge.ai/api/agents.md`
## Research
PolyBridge publishes 12 canonical public research articles covering forward-dated market data, world models, forecasting workflows, agentic finance, cyber risk, and World Cup economic effects.
- Human-readable Research index: `https://polybridge.ai/research`
- Agent-readable Research catalog: `https://polybridge.ai/research/llms.txt`
- Machine-readable JSON catalog: `https://polybridge.ai/research/index.json`
- XML sitemap: `https://polybridge.ai/sitemap.xml`
Use the Research catalogs above as the authoritative article list.
## Docs
- API overview: `https://polybridge.ai/api`
- AI Agent Hub: `https://polybridge.ai/api/agents`
- Connect Hosted MCP: `https://polybridge.ai/api/agents/connect`
- Market map workflow: `https://polybridge.ai/api/agents/market-map`
- Pre-trade check workflow: `https://polybridge.ai/api/agents/pre-trade-check`
- Agent-readable files: `https://polybridge.ai/api/agents/files`
- Authentication docs: `https://polybridge.ai/api/authentication`
- Standards and Conventions: `https://polybridge.ai/api/standards`
- Rate Limits: `https://polybridge.ai/api/rate-limits`
- Production guide: `https://polybridge.ai/api/production`
- Search docs: `https://polybridge.ai/api/search`
- Forecast docs: `https://polybridge.ai/api/forecast`
- RVOL docs: `https://polybridge.ai/api/rvol`
- MCP docs: `https://polybridge.ai/api/mcp`
- Console: `https://polybridge.ai/console`
- Privacy Policy: `https://polybridge.ai/privacy-policy`
- Terms: `https://polybridge.ai/terms`
- Support: `https://polybridge.ai/support`
- Contact: `https://polybridge.ai/contact`
- Full LLM context: `https://polybridge.ai/llms-full.txt`
- Agent instructions: `https://polybridge.ai/agents.txt`
- Machine-readable discovery: `https://polybridge.ai/.well-known/agents.json`
## Unsupported
No trading, orders, payments, sessions, market lookup, historical forward-dated market data APIs, Situation Rooms, internal APIs, or public Forecast streaming.