Skip to main content
Rypl

Why can't my app connect to Rypl?

Updated

Usually one of four things: your plan doesn't include the API, the key was cut off when you copied it, the app hasn't been restarted since you added Rypl, or the connection doesn't allow what you asked for. The error code tells you which.

Check these first

  • The plan. The API is on Pro and Ultra, the free trial included. On Simple, MCP and API Keys says "Part of the Pro and Ultra plans."
  • The whole key. A Rypl key is rypl_ followed by 48 characters. Copy it from the window in one go.
  • A new session. Claude Code sessions and a Gemini CLI that were already open don't see Rypl: start a new one. claude mcp list or gemini mcp list checks the connection. In Cursor and VS Code, confirm the install.
  • The command ran where the app lives. Run it in a terminal where claude or gemini works. Added Rypl before? Remove the old entry first with claude mcp remove rypl or gemini mcp remove rypl. Gemini CLI turns servers off in folders it doesn't trust, so run it from a folder you trust.
  • The app itself. Rypl's MCP server speaks Streamable HTTP. A client that knows only the older SSE transport can't connect. claude.ai and ChatGPT connectors aren't supported yet.

If the Connect an AI app window still says it is waiting, the app hasn't made its first request.

What the error code means

CodeWhat it meansWhat to do
401 invalid_keyNo key, a wrong one, or one that was disconnectedCopy the key again, or connect the app anew
401 expired_keyThe connection's Access ends date has passedConnect the app again
403 plan_requiredYour plan has no APIMove to Pro or Ultra
403 forbiddenThe connection wasn't given this: direct messages, settings, moderating or changing rulesConnect again with that switched on
404 not_foundNo such comment, or one this connection may not touchCheck the comment's id and the connection's channels
409The change can't be made: a comment with nothing to review (no_rule_task), a rule change that would delete (deletes_comments), rules kept as text (rules_as_text), a full list (limit_reached), or rules changing at the same moment (conflict, send it again)Read message
424 platform_errorFacebook, Instagram or TikTok refusedRead message, which carries their words
429 rate_limitedMore than 120 requests a minute, or 30 changesWait for the seconds in Retry-After
429 platform_rate_limitedThe platform itself is limiting requestsWait for the seconds in Retry-After
503 busyRypl is busyTry again after Retry-After

Every error comes as { "error": { "code", "message", "parameter" } }; for a wrong parameter, parameter names it and message says what it takes.

On this page