PolyBridge MCP

PolyBridge MCP gives Claude Desktop probabilistic foresight from live prediction markets and approved read-only RVOL access.

Ask a question about the future, even when no exact market exists. PolyBridge finds relevant markets, synthesizes the evidence, and returns a read-only forecast with probabilities and source-market metadata.

Search and Forecast can run without an API key at anonymous limits. Add `POLYBRIDGE_API_KEY` for higher Search/Forecast usage and for approved RVOL access with `rvol:read`.

PolyBridge MCP is read-only. It does not trade or move funds.

Tools

PolyBridge MCP exposes read-only tools:

• `polybridge_search`
• `polybridge_forecast`
• `polybridge_rvol_models`
• `polybridge_rvol_assets`
• `polybridge_rvol_latest`
• `polybridge_rvol_history`
• `polybridge_rvol_actuals`
• `polybridge_rvol_features_latest`

All tools are read-only. They do not place trades, submit orders, handle custody,

or perform write actions.

Search

`polybridge_search` retrieves relevant prediction markets for a topic or question.

• Search results return ranked prediction-market retrieval results.
• Scores are relevance/ranking scores, not probabilities.
• Local MCPB Search works without `POLYBRIDGE_API_KEY` at anonymous limits.
• Configure `POLYBRIDGE_API_KEY` only for higher Search usage.
• If `dimensions` is omitted, Search uses all supported dimensions by default:

`direct`, `upstream`, `downstream`, and `correlated`.

Forecast

`polybridge_forecast` generates read-only forecasts using PolyBridge market search and evidence synthesis.

• Forecast responses return forecast outputs and probabilities.
• Local MCPB Forecast works without `POLYBRIDGE_API_KEY` at anonymous limits.
• Configure `POLYBRIDGE_API_KEY` only for higher Forecast usage.
• A `search_forecast` key can power both Search and Forecast tools.

RVOL

The `polybridge_rvol_*` tools provide approved read-only access to PolyBridge realized-volatility model metadata, assets, latest forecasts, forecast history, actuals, and feature snapshot metadata.

• RVOL requires `POLYBRIDGE_API_KEY` with `rvol:read`.
• RVOL does not support anonymous access.
• If your key is not approved for RVOL, request access from PolyBridge.
• RVOL responses return curated backend JSON. They are not trading analysis or advice.

Non-goals

PolyBridge MCP does not provide:

• trading
• orders
• payments
• sessions
• market lookup
• Situation Rooms
• internal APIs
• custody
• write actions

Installation

1. Download the latest `.mcpb` package from GitHub Releases.

2. Open or import the file in Claude Desktop.

3. Enable the extension.

4. Search and Forecast can run without an API key at anonymous limits. Configure `POLYBRIDGE_API_KEY` for higher Search/Forecast usage or approved RVOL access.

Basic Usage

Ask Claude:

> Use PolyBridge Search to find active prediction markets related to US recession risk.

Or:

> Use PolyBridge Forecast to estimate the probability of a US recession in 2026.

Or, with an approved RVOL key:

> Use PolyBridge RVOL latest to fetch the latest BTC one-day realized-volatility forecasts.

API Key Configuration

• Local MCPB Search and Forecast work without `POLYBRIDGE_API_KEY` at anonymous limits.
• Configure `POLYBRIDGE_API_KEY` in the Claude Desktop extension settings for higher Search/Forecast usage or approved RVOL access.
• RVOL requires a PolyBridge API key with `rvol:read` and does not run anonymously.
• Invalid configured auth fails hard and does not fall back to anonymous.
• Use the PolyBridge Developer Console to create a Search+Forecast key or request approved RVOL access from PolyBridge.
• A `search_forecast` key can power both Search and Forecast tools.
• Do not paste API keys into chat.

Search Limits

Anonymous / local with no key:

• `top_k_per_dimension <= 50`
• `dimensions <= 4`

With `POLYBRIDGE_API_KEY`:

• `top_k_per_dimension <= 100`
• `dimensions <= 4`

Release Packaging

For a local v0.3.1 MCPB build, run:

python3 scripts/build_mcpb.py

This creates local artifacts only:

• `dist/polybridge-mcp-v0.3.1.mcpb`
• `dist/polybridge-mcp-v0.3.1.mcpb.sha256`

Do not publish, tag, or upload these files until the release has passed review.

Supported Search Dimensions

• `direct`
• `upstream`
• `downstream`
• `correlated`

REST API

The public REST API supports Search and Forecast without an API key at anonymous limits.

Add an API key for higher Search/Forecast usage. RVOL requires an approved PolyBridge API key with `rvol:read`.

• Search: `https://api.polybridge.ai/v1/search`
• Forecast: `https://api.polybridge.ai/v1/forecast`
• RVOL models: `https://api.polybridge.ai/v1/rvol/models`
• RVOL assets: `https://api.polybridge.ai/v1/rvol/assets`
• RVOL latest: `https://api.polybridge.ai/v1/rvol/latest`
• RVOL history: `https://api.polybridge.ai/v1/rvol/history`
• RVOL actuals: `https://api.polybridge.ai/v1/rvol/actuals`
• RVOL latest features: `https://api.polybridge.ai/v1/rvol/features/latest`

Hosted MCP

Hosted MCP is available at `https://mcp.polybridge.ai/mcp`. Search and Forecast

can run without an API key at anonymous limits. Add an API key or supported

OAuth for higher Search/Forecast usage. RVOL requires approved API-key access.

Invalid configured auth fails hard and does not fall back to anonymous.

Support

For higher usage, RVOL access, or other access questions, contact the PolyBridge team.