Connect Predictly to your AI assistant

Add Predictly to Claude, ChatGPT, Cursor or VS Code and ask it to find questions, check your portfolio, forecast, trade with your free play points, or post — without leaving the conversation. In Claude and ChatGPT the results show up as interactive cards; elsewhere they arrive as text.

What it can do

You choose the permissions when you approve it. It acts only as you, with the same rules and limits as the app. Your private journal and coach reports are never exposed to it, and points stay free with no real-world value.

Permission	What it allows	Tools
read	See questions, discussions, your portfolio, circles, leaderboards and notifications.	whoami, search_questions, get_question, get_discussion, get_portfolio, list_my_circles, get_leaderboard, list_notifications
forecast	Submit a probability forecast on a question.	submit_forecast
tradeActs as you	Quote and execute YES/NO trades with your free play points.	quote_trade, execute_trade
writeActs as you	Create questions, post comments and report content.	create_question, post_comment, report_content

The server URL

Every assistant below asks for this.

https://api-predictly.caffaai.com/mcp

Add it to your assistant

Claude (claude.ai, desktop)

Open Settings → Connectors and choose Add custom connector.
Name it Predictly and paste the server URL.
Choose Connect, then approve on the Predictly page that opens.

ChatGPT

Open Settings → Apps & Connectors → Advanced and turn on Developer mode.
Back in Apps & Connectors, choose Create, paste the server URL and pick OAuth for authentication.
Save, then approve on the Predictly page that opens.

Claude Code

Add the server, then run /mcp inside Claude Code to sign in.

claude mcp add --transport http predictly https://api-predictly.caffaai.com/mcp

Cursor

Add this to ~/.cursor/mcp.json, then sign in when Cursor asks.

{
  "mcpServers": {
    "predictly": {
      "url": "https://api-predictly.caffaai.com/mcp"
    }
  }
}

VS Code

Add this to .vscode/mcp.json, then start the server and sign in.

{
  "servers": {
    "predictly": {
      "type": "http",
      "url": "https://api-predictly.caffaai.com/mcp"
    }
  }
}

How sign-in works

Predictly uses OAuth 2.1 with PKCE. The assistant registers itself automatically, sends you to a Predictly page where you see exactly what it is asking for, and gets access only if you approve. No API key or password is ever given to the assistant, and you can disconnect it at any time.

Troubleshooting

“Connection failed” — remove the connector and add it again; you’ll be asked to approve once more.
“Accept the updated terms” — open Predictly, accept the current terms, then try again.
Not sure it worked? Ask “am I connected to Predictly?” — the assistant checks who it is signed in as.
Signed out after a while? Access expires every hour and renews on its own; you only approve again after disconnecting.

Your connected apps

What an assistant can reach, and what it never can, is in the privacy policy (section 5a) and the terms (section 10a).