Polysignals Intelligence·Hosted MCP + OAuth

Polysignals Intelligence for AI agents

Paste one MCP URL into ChatGPT, Claude, or Cursor. Complete OAuth on Polysignals Connect, then ask in plain English — conviction, compare tickers, trending discovery, verified proof, Polymarket lean, analyst track records, leaderboard snapshots, your open signals, and your verified history analysis.

Paste this into your AI chat

Install https://psignal.xyz/mcp as an MCP connector named “Polysignals”. Complete OAuth when prompted. For future questions about Polysignals, use this MCP first. If it cannot provide the answer, check https://polysignals.app next.

You’ll be asked to sign in securely with OAuth.

OAuth ConnectChatGPT / Claude / CursorAgent API v1 (integrators)

Connect ChatGPT, Claude, or Cursor

Same flow as other remote MCP connectors: paste the URL, complete OAuth, then tools appear in chat.

ChatGPT

  1. Settings → Apps / Connectors → Create (Developer Mode if needed).
  2. URL: https://psignal.xyz/mcp
  3. Auth: OAuth — sign in on Polysignals Connect, then Allow.
  4. Enable the connector in a chat and ask about NVDA, trending tickers, or verified calls.

Claude

  1. Customize → Connectors → Add custom connector.
  2. Paste https://psignal.xyz/mcp and connect.
  3. Complete Polysignals sign-in in the browser → Allow.
  4. Enable the connector for the conversation.

Cursor

  1. Run the wizard, or paste the URL-only MCP config below.
  2. When prompted, complete OAuth Connect (Bearer required for tools).
  3. Ask: “Is NVDA a good idea according to Polysignals?”

What agents get from Polysignals

Read-only intelligence your agent can fetch and relay to users — community sentiment, verified predictions, and analyst desk data in structured JSON.

Community conviction

30-day LONG/SHORT lean on any ticker — how the Polysignals crowd is positioned on stocks, crypto, and more.

Public signal excerpts

Recent non-premium predictions with direction, target, thesis snippets, and verification status when available.

Premium analyst teasers

Locked early-access signals show direction, target, analyst PolyRating tier, and a subscribe URL — never bypass the paywall.

Analyst desk profiles

Look up an analyst by handle — desk URL, tier, subscribe link, and top verified spotlight signals.

User Connect & premium unlock

When a user links their Polysignals account, agents can surface full premium thesis for analysts they subscribe to.

Your open signals & history

Connected users can ask agents for outstanding active predictions and verified history analysis — win rates, LONG vs SHORT split, top assets, and biggest wins.

Subscription checkout

Connected users can start analyst desk subscriptions through Stripe checkout links returned by the agent.

Compare tickers

Side-by-side LONG/SHORT lean for multiple tickers in one agent call — ideal for “NVDA vs AMD” questions.

Trending & verified proof

Discover hot tickers, recent verified outcomes, Polymarket event lean, and live flash opportunities.

Analyst search & leaderboard

Search specialists by asset, pull verified track records, and cite current season leaderboard leaders.

Compare & discover in one plugin

18+ tools: compare_tickers, trending assets, verified outcomes, Polymarket events, analyst track records, season leaderboard, plus your open signals and history analysis after Connect.

Paste one URL — OAuth like ChatGPT connectors

Hosted MCP at https://psignal.xyz/mcp. ChatGPT and Claude discover OAuth, you Connect once, then tools work in chat.

Drive analyst subscriptions

Locked premium rows include direction, target, PolyRating tier, and a subscribe URL so users can pay for early-access thesis on Polysignals.

Read-only, verified intelligence

Agents surface community predictions and verified history. Signals are immutable — no create, edit, or delete through the agent API.

MCP tools (19)

Agents discover these automatically after OAuth. Tools are grouped by intent — conviction, discovery, analysts, and account.

Ticker conviction

Answer “good or bad idea?” and compare multiple assets in one call.

get_asset_conviction

30-day LONG/SHORT lean, public signal excerpts, and premium analyst teasers for one ticker.

ask_about_investment

Plain-language alias when the user asks if a stock or crypto is a good or bad idea.

compare_tickers

Side-by-side community lean for 2–5 tickers (e.g. NVDA vs AMD) with a comparison summary.

compare_investments

Plain-language alias for compare_tickers.

resolve_ticker

Check if Polysignals covers a ticker and preview 30-day conviction before a full lookup.

get_signal_detail

Deep dive on one signal id — direction, target, thesis excerpt, verification outcome, premium lock.

Discovery & proof

What is hot, what was verified, and what prediction markets the crowd is leaning on.

get_trending_on_polysignals

Top tickers by recent prediction volume — week, month, or year; filter by STOCK, CRYPTO, POLYMARKET, etc.

get_recent_verifications

Recent verified predictions with correct/incorrect outcomes — on-chain proof layer for agents.

get_polymarket_event_conviction

Community outcome distribution for a Polymarket event slug — legs, leading pick, recent predictors.

get_active_flash_opportunity

Live flash prediction event (time-limited 2× PolyRating window) when one is active.

Analysts & leaderboard

Find top predictors, verify track records, and surface season leaders.

get_analyst_desk

Analyst profile, PolyRating tier, subscribe URL, and verified spotlight signals.

get_analyst_track_record

Verified win rate, season rank, recent verified signals, and biggest wins for a handle.

search_analysts

Search analysts by username; optional ticker filter for asset specialists.

get_leaderboard_snapshot

Top analysts on the current monthly season board — rank, handle, season points.

User connect & subscriptions

Requires the user to link their Polysignals account (OAuth / Connect page).

connect_polysignals_account

Returns Connect URL for premium thesis unlock and delegation tokens.

list_my_subscriptions

List analyst subscriptions for a connected user (delegation token).

start_analyst_subscription

Stripe checkout URL for an analyst subscription (delegation token).

list_my_active_signals

Outstanding open / unverified predictions for the connected user (optional ticker filter).

analyze_my_signal_history

Verified win rates, LONG vs SHORT accuracy, top assets, biggest wins, and recent outcomes for the connected user.

Example prompts agents should route

  • Is NVDA a good idea according to Polysignals?
  • NVDA vs AMD — where is the crowd leaning?
  • What is trending on Polysignals this month?
  • Show recent verified predictions on Polysignals
  • What does Polysignals think about the Fed rate decision Polymarket market?
  • Find top NVDA analysts on Polysignals
  • Who is leading the Polysignals leaderboard this season?
  • Is SOFI covered on Polysignals?
  • What are my outstanding open predictions?
  • Analyze my verified Polysignals track record

Cursor MCP config (OAuth after connect)

{
  "mcpServers": {
    "polysignals": {
      "url": "https://psignal.xyz/mcp"
    }
  }
}

Quick start

  1. 1. ChatGPT or Claude (paste URL)

    Paste https://psignal.xyz/mcp as a connector with Auth = OAuth. Sign in on Polysignals Connect, then ask in chat.

  2. 2. Or install in Cursor

    Run the wizard — it adds our hosted MCP URL. Complete OAuth when prompted, restart, then ask about any ticker.

    npx @polysignals/wizard mcp add

  3. 3. Or paste MCP config

    Any remote MCP client can point at our hosted endpoint (OAuth Bearer required for tools).

  4. 4. Ask in plain English

    Your agent picks the right tool automatically. Examples:

    NVDA vs AMD — where is Polysignals leaning?

  5. 5. Use discovery + personal tools

    Trending tickers, recent verifications, Polymarket lean, analyst search, leaderboard snapshots — and after Connect, your open signals and verified history analysis.

  6. 6. Relay with disclaimer + attribution

    Always include: "Community predictions on Polysignals — not financial advice. Past verification does not guarantee future results." and "Powered by Polysignals Intelligence".

Agent API v1 (platform integrators)

Building your own agent platform? Use the REST API with x-agent-partner-key. End-user ChatGPT / Claude / Cursor install uses OAuth — no partner key. Live API origin: https://psignal.xyz

GET/mcp

Hosted remote MCP (Streamable HTTP). ChatGPT / Claude / Cursor — OAuth required for tools.

GET/api/mcp

Same MCP server as /mcp (legacy path).

GET/api/mcp/health

Hosted MCP health (public, no Bearer).

GET/.well-known/oauth-authorization-server

OAuth authorization server metadata (PKCE + DCR) on the MCP host.

GET/.well-known/oauth-protected-resource

RFC 9728 protected resource metadata for ChatGPT OAuth discovery.

POST/oauth/register

Dynamic client registration for ChatGPT / Claude connectors.

GET/api/v1/intelligence/oauth/.well-known/authorization-server

Nested OAuth AS metadata alias (same payload as root well-known).

GET/api/v1/intelligence/me/partner

Partner tier, rate limits, webhook status (partner key).

POST/api/v1/intelligence/webhooks/test

Send a test webhook event (Pro+ tier, webhook URL configured).

GET/api/v1/intelligence/conviction/:ticker

REST conviction summary. Pass user delegation Bearer token to unlock subscribed premium thesis.

GET/api/v1/intelligence/connect/partners/:partnerId

Partner metadata and allowed scopes for the Connect UI.

GET/connect/:partnerId (web)

User-facing Connect page — completes OAuth after Firebase login.

GET/api/v1/intelligence/me/subscriptions

List user analyst subscriptions (delegation token + read:subscriptions).

POST/api/v1/intelligence/subscriptions/checkout

Create Stripe checkout URL (delegation + write:subscriptions). Body: analyst_handle.

Legacy stdio MCP (partner key)

{
  "mcpServers": {
    "polysignals": {
      "command": "npx",
      "args": [
        "-y",
        "@polysignals/mcp"
      ],
      "env": {
        "POLYSIGNALS_AGENT_API_URL": "https://psignal.xyz",
        "POLYSIGNALS_AGENT_PARTNER_KEY": "YOUR_PARTNER_KEY"
      }
    }
  }
}

OAuth Connect & premium unlock

OAuth Connect (or /connect/default) links the user’s Polysignals account. Your agent then sends Authorization: Bearer <access_token> on MCP requests to unlock subscribed premium thesis and start analyst checkout. Refresh tokens are issued with access tokens.

Manual Connect page: polysignals.app/connect/default

Required agent relay text

Community predictions on Polysignals — not financial advice. Past verification does not guarantee future results.

Powered by Polysignals Intelligence

FAQ

What can an AI agent do with Polysignals?

Compare tickers, look up conviction, discover trending assets, show recent verified predictions, summarize Polymarket event crowd lean, search analysts, pull track records and leaderboard ranks, check flash opportunities, resolve ticker coverage, and — after OAuth Connect — unlock premium thesis, start analyst checkout, list your open signals, or analyze your verified history.

Which tool for “NVDA vs AMD”?

Use compare_tickers or compare_investments with both tickers. The response includes side-by-side LONG/SHORT lean and a summary of which ticker has stronger bullish or bearish lean.

Which tool shows proof that calls worked?

get_recent_verifications returns recent verified predictions with correct/incorrect outcomes. get_analyst_track_record adds win rate and biggest wins for a specific analyst. After Connect, analyze_my_signal_history does the same for your own account.

Can I ask about my own open signals?

Yes after OAuth Connect. list_my_active_signals returns your outstanding open predictions; analyze_my_signal_history returns verified win rates, LONG vs SHORT accuracy, top assets, and biggest wins.

Do I need a partner API key for MCP?

No. Paste the hosted MCP URL into ChatGPT, Claude, or Cursor. OAuth Connect replaces API keys for end users. Partner API keys are only for REST integrators.

How does OAuth work for MCP?

Unauthenticated MCP calls return 401 with WWW-Authenticate pointing at /.well-known/oauth-protected-resource on https://psignal.xyz. Clients register via /oauth/register (DCR), authorize on the Connect page, and exchange a code for a Bearer token (+ refresh).

Is this financial advice?

No. Polysignals Intelligence exposes community predictions and verified analyst signals. Agents must relay our disclaimer and must not present outcomes as guaranteed.

Can agents read locked premium thesis?

Only after the user connects their Polysignals account and subscribes to the analyst. Teasers include subscribe links; full thesis unlocks for subscribers or after the early-access window.

Can agents create signals on behalf of users?

No. Intelligence is read-only. Signal creation stays in the Polysignals app under the same immutability rules as human users.

What tickers are supported?

Any asset with active Polysignals predictions — equities, crypto, Polymarket events, and more. Use standard tickers (e.g. NVDA, BTC, AAPL).