Documentation Index
Fetch the complete documentation index at: https://docs.rheos.app/llms.txt
Use this file to discover all available pages before exploring further.
The Rheos MCP server lives at:
It supports two auth modes:
- OAuth 2.1 — recommended for hosted clients (claude.ai, ChatGPT). The client redirects you to
rheos.app, you approve, and a short-lived token is issued.
- API key (Bearer) — recommended for local CLIs (Claude Code, Cursor, Windsurf). Generate one in Settings → MCP and paste it into the client config.
The OAuth flow uses the standard MCP discovery endpoint at https://mcp.rheos.app/.well-known/oauth-protected-resource. Clients that implement MCP authorization will pick this up automatically. Generate an API key
Create a key
Click New API key, give it a label (e.g. “Cursor laptop”), and copy the secret. You’ll only see it once.
Store it safely
Treat the key like a password. Anyone with it can act as you in Rheos. Revoke unused keys from the same screen.
Client setup
claude.ai
Claude Code
Cursor
ChatGPT
Other clients
Claude.ai uses OAuth — no API key needed.Open Connectors
In claude.ai, click your avatar → Settings → Connectors → Add custom connector.
Add Rheos
- Name:
Rheos
- URL:
https://mcp.rheos.app
Click Add.Authorize
Claude.ai will redirect you to rheos.app to log in and approve. After approval you’ll be bounced back with the connection active.
Test
Start a new chat and ask: “What Rheos brands do I have?” Claude should call rheos_list_brands and return your brands.
Claude Code can connect either directly (HTTP transport) or through the mcp-remote shim. Direct HTTP is preferred where the client supports it.Option A — direct HTTP (~/.claude/settings.json):{
"mcpServers": {
"rheos": {
"type": "http",
"url": "https://mcp.rheos.app",
"headers": {
"Authorization": "Bearer rk_live_your_api_key_here"
}
}
}
}
mcp-remote (works everywhere npx does):{
"mcpServers": {
"rheos": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.rheos.app",
"--header",
"Authorization: Bearer rk_live_your_api_key_here"
]
}
}
}
/mcp to reload). You should see rheos listed under connected servers. Edit ~/.cursor/mcp.json (create it if it doesn’t exist):{
"mcpServers": {
"rheos": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.rheos.app",
"--header",
"Authorization: Bearer rk_live_your_api_key_here"
]
}
}
}
ChatGPT’s custom connector framework is rolling out gradually. If you don’t see the option in your account, fall back to claude.ai or Claude Code in the meantime.
Open Connectors
In ChatGPT, go to Settings → Connectors → Create.
Add Rheos
- Name:
Rheos
- MCP Server URL:
https://mcp.rheos.app
- Authentication: OAuth
Save.Authorize
ChatGPT will open a rheos.app window for sign-in and consent.
Any MCP client that supports the Streamable HTTP transport will work. The
pattern is always the same:npx -y mcp-remote https://mcp.rheos.app \
--header "Authorization: Bearer rk_live_your_api_key_here"
mcp-remote package handles the HTTP-to-stdio bridge. Verifying the connection
Once connected, any of these prompts should produce a tool call:
- “List my Rheos brands.” →
rheos_list_brands
- “What’s my Rheos credit balance?” →
rheos_get_credits
- “Show me the formula tree.” →
rheos_get_formulas
If the client returns “no tools available”, check:
- The Authorization header is exact —
Bearer prefix included, no trailing whitespace.
- The key hasn’t been revoked. Re-check Settings → MCP in the dashboard.
- Your client supports the Streamable HTTP transport (most do as of 2026).
Never commit API keys to git. Use environment variables, a secret manager, or the client’s native credential store.
Rotating or revoking keys
Open Settings → MCP in the Rheos dashboard. Each key shows its last-used
timestamp. Click Revoke to invalidate it immediately — any client using
that key will start returning 401 within seconds.
To rotate, generate a new key first, update your client config, then revoke
the old one.
