What you can ask
Some example prompts that work out of the box:- “Who applied to the Senior Engineer role this week?”
- “Show me candidates in final-round interviews.”
- “Which open roles still haven’t had a first-round interview?”
- “What interviews are scheduled for tomorrow?”
- “Find the candidate whose email is jane@example.com.”
Get set up
1
Create a Ribbon account
Sign up at app.ribbon.ai. You’ll need to be an admin on your org to connect an ATS or enable MCP.
2
Connect your ATS
Go to Settings → Integrations, pick your ATS (Ashby, Greenhouse, Lever, Workable, and many more via Kombo), and complete the authorization flow. Wait for the first sync to finish — Ribbon MCP can’t read from an integration that’s still setting up.See ATS Integrations for more detail.
3
Connect Ribbon to Claude
In the left nav, click Ribbon MCP, then Connect in Claude. Claude will open in a new tab with Ribbon pre-filled as a custom connector. Approve access when prompted.That’s it — Claude can now answer questions about your pipeline.
What Claude can see
Ribbon MCP exposes six read-only tools:
Claude picks the right tool automatically based on what you ask.
Use with ChatGPT, Cursor, or other clients
The same server works with any MCP client. Instead of clicking “Connect in Claude”, copy the server URL from the Ribbon MCP page into your client’s MCP or Connectors settings:Security and privacy
- Read-only. No tool call can modify your ATS.
- Scoped to your org. Claude only sees data for the Ribbon org you signed in to approve access.
- Revocable. Disconnect the connector in Claude’s settings at any time; the access token stops working immediately.
- OAuth 2.1 with PKCE. Your credentials never leave Ribbon; Claude gets a short-lived access token, not your password.
