Connect to AI assistants (MCP)

Diviner One has a hosted MCP server, so AI assistants like Claude can work directly in your account — pulling your reviews, drafting prompt pages, generating web page plans, replying to Google reviews, and managing your CRM pipeline — all on your behalf.

MCP (Model Context Protocol) is an open standard that lets AI tools securely call external services. Once connected, you just ask your assistant in plain language ("plan a service page for 'emergency plumber Portland'", "reply to my unanswered Google reviews", "move the Acme deal to proposal") and it uses the right Diviner One tools for you.

What you can do

• Reviews — list reviews and stats, find unanswered Google reviews, and post or edit replies
• Web Page Planner — generate full AI page outlines, regenerate a single section, and manage saved plans
• Prompt pages — list, create, set status, and assign review-capture pages
• CRM — manage the deals pipeline (create/update/move/delete deals, add notes) and contact forms
• Social posting — publish to Google Business Profile, LinkedIn, and Bluesky now or on a schedule; manage drafts and the queue
• Google Business Profile — pull performance metrics (views, calls, clicks, directions, searches) and a profile-health overview
• Keywords, rank tracking & LLM visibility — create and organize keyword concepts, enrich them with search volume, and read your rankings and AI-search visibility
• Widgets, contacts, surveys, work manager, and email marketing — read and manage across the platform

Step 1 — Create an API key

1. Go to Account → API keys (or open the Connect to MCP card on your account page)
2. Click Create API key and give it a name (e.g. Claude)
3. Copy the key — it starts with pr_live_ and is shown only once
4. Store it somewhere safe immediately

Your key acts as your account's credential. Treat it like a password — anyone with it can act on your account. You can revoke a key any time from the same screen.

Step 2 — Connect your AI assistant

The server endpoint is:

https://mcp.divinerone.com/mcp

Authentication is the standard HTTP Authorization header — your API key is sent as a bearer token. You do not paste the key into a chat; you configure it once in your client.

Claude Code (command line)

Run this once, replacing the key with your own:

claude mcp add --transport http divinerone https://mcp.divinerone.com/mcp --header "Authorization: Bearer pr_live_YOUR_KEY"

Claude Desktop

Add this to your claude_desktop_config.json (Settings → Developer → Edit config), then restart Claude Desktop:

{
  "mcpServers": {
    "divinerone": {
      "url": "https://mcp.divinerone.com/mcp",
      "headers": {
        "Authorization": "Bearer pr_live_YOUR_KEY"
      }
    }
  }
}

Other MCP-compatible clients work the same way: point them at the URL above and send Authorization: Bearer <your key>.

What your assistant can access

Your key only reaches your own account — the MCP can never touch another customer's data. If you are on an agency plan, your key can also act on the client accounts your agency manages; ask your assistant to switch accounts (or it will use your default account otherwise).

Available tools

See the full MCP tool reference for the complete, always-current list.

Once connected, your assistant sees these tools automatically. You rarely call them by name — just describe what you want — but here is the full set:

• Account — list accounts, switch the active account
• Reviews — list reviews, stats, and sources; list unanswered Google reviews; post and edit Google review replies
• Web Page Planner — list, view, generate, regenerate a section of, and delete page outlines
• Prompt pages — list, create, set status, and assign
• CRM deals — list, view, create, update, delete deals; view and add timeline notes; view and edit pipeline settings
• CRM contact forms — list, create, update, delete forms and their Slack notifications
• Businesses & contacts — view business details and locations; search, view, and create contacts
• Google Business Profile — list connected locations; pull performance metrics and a profile-health overview
• Social posting — list connections and posts; publish now, schedule, draft, bulk-schedule, reorder, edit/cancel, and post immediately
• Keywords & rank tracking — list, create, and bulk-create keyword concepts; enrich them with search volume, difficulty, and CPC (via DataForSEO); view rank-tracking results and history
• LLM visibility — view results and summary; run a new visibility check
• Widgets — list widgets and their reviews
• Surveys — create surveys
• Work manager — boards, tasks (create/update/delete), and time entries
• Email marketing — lists, subscribers, campaigns (create/update/test/send/analytics), and settings
• Credits & notifications — check your credit balance and ledger; list notifications

A note on credits

Some actions use account credits, just like they do in the app — generating or regenerating a web page plan, running an LLM visibility check, and publishing or scheduling a social post. Your assistant will tell you the credits used and your remaining balance after each one. Reading data never costs credits.

Troubleshooting

• "Missing API key" or 401 errors — your client is not sending the Authorization: Bearer pr_live_... header. Re-check the config from Step 2.
• 403 on an account — the key is not allowed to act on that account. Use your own account, or (on an agency plan) a client your agency manages.
• The new tools do not appear — reconnect or restart your client; MCP clients load the tool list when they connect.