Connect your AI agent
ReGrade's tools run over the Model Context Protocol — one endpoint, the same for every agent. Recording and replay stay on the CLI; profile creation and delta querying happen through your MCP client.
MCP endpoint
https://api.regrade.curtail.com/api/v1/mcpScopes
recordings:readreplays:readreplays:writedeltas:readdeltas:writeprofiles:readprofiles:writemcp:execute
Claude Code
Browser OAuth (PKCE) — no API key- Add the ReGrade marketplace and install the plugin, then restart Claude Code.
- Type /mcp, select ReGrade, and complete the browser login to authorize access.
- First call: ask Claude to list_recordings.
claude plugin marketplace add https://app.regrade.curtail.com/downloads/latest/marketplace.json
claude plugin install regrade@regradeClaude Desktop
Browser OAuth- Open Settings → Developer → MCP Servers → Add.
- Pick "Custom" (not "New MCP server"). Name it regrade and paste the endpoint URL.
- Click connect and complete OAuth in the popup. First call: ask Claude to list_recordings.
GitHub Copilot
Browser OAuth (VS Code / JetBrains)- Add the server block to your workspace .vscode/mcp.json (or the JetBrains MCP config).
- Click Auth in the CodeLens above the server entry to authenticate via browser.
- First call: in agent mode, ask "use ReGrade to list my recent recordings."
.vscode/mcp.json
{
"mcpServers": {
"regrade": {
"type": "http",
"url": "https://api.regrade.curtail.com/api/v1/mcp"
}
}
}Lovable
Browser OAuth- Open Settings → Integrations → MCP.
- Use the "Custom" connector card (not "New MCP server"). Paste the same endpoint.
- Complete OAuth; the ReGrade tools appear in the chat picker.
Windsurf
OAuth via config- Open Settings → Advanced Settings → Cascade → Open MCP Registry.
- Click the gear icon to edit mcp_config.json directly and add the server block.
- Save and return to the registry; the regrade row appears and prompts for OAuth.
mcp_config.json
{
"mcpServers": {
"regrade": {
"serverUrl": "https://api.regrade.curtail.com/api/v1/mcp"
}
}
}Any other MCP client
Point it at the endpoint above with an HTTP transport ({ "type": "http", "url": … }) and authorize via OAuth, or use an API key on non-browser surfaces. For the full, OS-specific walkthrough — install, record, replay, then connect — see the downloads guide.