RenewRoster MCP server

REST APIMCP serverOpenAPI 3.1 spec

RenewRoster runs a remote Model Context Protocol server, so AI assistants can check and manage your agency's domains and SSL certificates.

1. Create an API key

In the dashboard open API and create a key. Choose Read-only if the assistant should only look things up, or Read + write to let it add and remove assets. Copy the key; it's shown once.

2. Add the server to your client

Claude Code

claude mcp add --transport http renewroster https://app.renewroster.com/mcp --header "Authorization: Bearer $RR_KEY"

Claude Desktop

Settings → Developer → Edit Config, then add (uses mcp-remote to pass the header):

{
  "mcpServers": {
    "renewroster": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.renewroster.com/mcp", "--header", "Authorization:${RR_AUTH}"],
      "env": { "RR_AUTH": "Bearer rr_live_xxxxxxxxxxxx_yourSecret" }
    }
  }
}

Cursor

~/.cursor/mcp.json (or .cursor/mcp.json in a project):

{
  "mcpServers": {
    "renewroster": {
      "url": "https://app.renewroster.com/mcp",
      "headers": { "Authorization": "Bearer rr_live_xxxxxxxxxxxx_yourSecret" }
    }
  }
}

VS Code (GitHub Copilot)

.vscode/mcp.json. VS Code prompts for the key and stores it securely:

{
  "inputs": [{ "type": "promptString", "id": "rr-key", "description": "RenewRoster API key", "password": true }],
  "servers": {
    "renewroster": {
      "type": "http",
      "url": "https://app.renewroster.com/mcp",
      "headers": { "Authorization": "Bearer ${input:rr-key}" }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "renewroster": {
      "serverUrl": "https://app.renewroster.com/mcp",
      "headers": { "Authorization": "Bearer rr_live_xxxxxxxxxxxx_yourSecret" }
    }
  }
}

Keep keys out of shared repos. Prefer environment variables or your client's secret input.

Tools

Write tools only appear when the key is read + write.

Example prompts

• "Which client domains or SSL certificates expire in the next 14 days? Group them by client."
• "Is anything already expired? Draft a short email to each affected client."
• "Start tracking acme.com and www.acme.com under the client Acme."
• "Re-check shop.example.com. Did the renewal go through?"
• "When does stripe.com's domain registration expire?" (live lookup, nothing saved)
• "Import these 40 domains under the client Globex, then show my plan usage."
• "Mark every Acme domain as client-paid with auto-renew on."
• "Which webhook deliveries failed this week?"

Dashboard-only

For security these stay in the dashboard and are not available through the API or MCP: billing, plan changes, checkout and invoices; inviting members and changing roles; deleting the agency; creating or revoking API keys; agency branding; and admin operations. Webhook secrets are shown only once, when the webhook is created.

Troubleshooting

• 401: the key is missing, mistyped or revoked. Check the Bearer prefix.
• Write tools missing: the key is read-only. Create a read + write key.
• 429: you hit the per-minute limit. Wait for Retry-After seconds.

Source and registry

Server metadata and client examples are on GitHub at raghuchinnannan/renewroster-mcp, and the server is listed in the official MCP registry as com.renewroster/renewroster.

Prefer plain HTTP? See the REST API docs.