The Model Context Protocol (MCP) is an open standard that lets AI systems like Claude Code connect to external services and use them as tools within a conversation. Aurrus ships a production MCP server at aurr.us/mcp. Once connected, Claude Code can read and manage your reminders, inspect your widget configuration, and query subscription status — all without opening a browser or writing API glue code manually. This guide walks through how to connect and what you can do once connected.

What Is the Aurrus MCP Server?

The MCP server is an HTTP endpoint that implements the Model Context Protocol specification. It exposes Aurrus capabilities as typed tool definitions that MCP-compatible clients can discover and invoke. When you connect Claude Code to the Aurrus MCP server, Claude Code can call those tools as part of a natural language conversation. Instead of asking Claude Code to write a script that hits the Aurrus REST API, you simply describe what you want and Claude Code calls the appropriate MCP tool directly.

Connecting Claude Code to aurr.us/mcp

To connect Claude Code to the Aurrus MCP server, add the following to your Claude Code MCP configuration file (typically at ~/.claude/settings.json or the project-level .claude/settings.json):

  • Server URL: https://aurr.us/mcp
  • Authentication: Bearer token from your Aurrus dashboard (Settings → API Keys)
  • Transport: HTTP (the Aurrus MCP server uses streamable HTTP transport)

Once added, restart Claude Code and the Aurrus tools will appear in the available tool list. You can verify the connection by asking Claude Code: "List my Aurrus tools" — it will enumerate all available actions.

Available MCP Tools

The Aurrus MCP server exposes tools across three areas:

  • Reminder management: List all active reminders, create a new reminder from a natural language description, pause or delete a reminder by ID, and query the next scheduled fire time for any reminder.
  • Voice widget configuration: Read the current system prompt for any of your widgets, update the system prompt, toggle voice output on or off, and retrieve conversation log summaries.
  • Subscription and usage: Query your current tier, check remaining Claude message quota for the billing period, and retrieve the billing portal URL.

The tool list evolves as Aurrus adds new features. The MCP server advertises its full tool schema on connection, so Claude Code automatically picks up new tools without configuration changes on your end.

Practical Workflows with Claude Code + Aurrus MCP

Here are three concrete workflows that become straightforward once Claude Code is connected to the Aurrus MCP server:

  • Bulk reminder audit: "Show me all my active reminders and tell me which ones have not fired in the last two weeks." Claude Code calls the list reminders tool, inspects the last-fire timestamps, and returns a filtered list with recommendations.
  • System prompt iteration: "Read my voice widget system prompt and suggest improvements based on the conversation logs from last week." Claude Code reads the system prompt and log summary via MCP, reasons about gaps, and drafts an updated system prompt for your review.
  • Subscription health check: "Am I close to my Claude message limit for this billing period, and should I upgrade?" Claude Code queries usage via MCP and gives a straightforward recommendation based on your current consumption rate and days remaining in the period.

Security and Authentication

The Aurrus MCP server authenticates every request using your personal API key. The key is tied to your Aurrus account and respects your subscription tier — tools that require a Pro or Business subscription return a clear error message if called from a Starter account, rather than silently failing. You can generate, rotate, and revoke API keys from your dashboard at aurr.us under Settings → API Keys. Treat your MCP API key like any other API credential: keep it out of public repositories and rotate it if you suspect it has been exposed.

Using the Aurrus MCP Server with Other AI Tools

The Aurrus MCP server is not limited to Claude Code. Any MCP-compatible client can connect to it. The MCP ecosystem is growing rapidly, and as more AI development tools add MCP support, the same Aurrus server becomes available to all of them. If you are building a custom AI workflow, internal tool, or personal automation that needs access to reminder data or widget configuration, the MCP endpoint at aurr.us/mcp and the full API documentation at aurr.us/docs are the starting points.