Agent setup

For AI agents. Aura manages a WordPress agency's hosting, Cloudflare and sites from one place, and exposes them to you through one MCP server. Follow these steps to connect and to onboard your human.

1. Add the Aura MCP server

Your human creates your token at https://app.my-aura.app/onboarding and gives it to you. Replace <YOUR_TOKEN> with it. In Claude Code:

claude mcp add --transport http aura-fleet https://app.my-aura.app/api/mcp/fleet --header "Authorization: Bearer <YOUR_TOKEN>"

Other agents — add this to the MCP configuration (for example .mcp.json):

{
  "mcpServers": {
    "aura-fleet": {
      "type": "http",
      "url": "https://app.my-aura.app/api/mcp/fleet",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

2. Follow the checklist

Call aura__onboarding_status and do its nextStep. Repeat until it reports complete: true. The required steps are a hosting provider and one WordPress site connected with SiteAgent; Cloudflare is optional but recommended.

3. Check your tasks

At the start of every session, call aura__list_tasks. For each open task: take it with aura__update_task (status: "taken"), prepare the change for the listed sites, and mark it done with the runIds you got back. Your human sees the task's state and your runs on their dashboard.

4. Rules

  • Credentials never pass through you. Never ask your human to paste an API key, password or token into the conversation. The tools return a link; your human opens it and enters the key in Aura.
  • Ask before you open a browser. Give your human the link and ask whether to open it.
  • Changes to a live site still go through Aura's approval queue — your human approves them.
  • A task is a request, not a permission. Every change you make for a task still waits for approval in Aura.

Onboarding and task tools

  • aura__onboarding_status — The checklist for your client: each step's done/required state and the next step. Call it first, and again after each step.
  • aura__request_provider_connection — Returns a one-time link (60 minutes) where the human enters the hosting provider's or Cloudflare's API key in Aura. Never takes credentials.
  • aura__get_connection_request — Polls a request: pending, connected, failed or expired.
  • aura__request_site_connection — Returns the steps for the human to connect one WordPress site with the SiteAgent plugin, and a request id to poll.
  • aura__list_tasks — Tasks your human queued for you in Aura ("Let the agent handle it" on a security item): the advisory, its detail and the affected sites. Call it at the start of every session.
  • aura__update_task — Marks a task taken (before you start) or done (with the runIds of the runs you created and an optional note). It changes only the task — never executes or approves anything.