Skip to content
Documentation menu

Documentation

MCP: run Ansengine from an AI assistant

64 tools in Claude, ChatGPT, Cursor and Claude Code, with a two step confirm on every action that spends or cannot be undone.

The MCP server runs the measure, diagnose, fix and prove loop without the dashboard. It calls the same core your console uses, so plan limits, roles and budgets apply identically.

Connect it

  1. 1Mint an API key under Settings, then API. API and MCP access are included from the $79 tier up.
  2. 2Add the server to your client with the key as a Bearer token.
  3. 3Call list_brands first: every other org tool takes a brandId from that list.
{
  "mcpServers": {
    "ansengine": {
      "url": "https://mcp.ansengine.co/mcp",
      "headers": { "Authorization": "Bearer ak_your_key_here" }
    }
  }
}

What agents can do

  • Read everything the dashboard shows: visibility, trends, competitors, sources, the funnel, prompts, locations, receipts, the QBR, budget status.
  • Configure: add or archive prompts, set competitors, seed the outreach worklist.
  • Act: run scans and audits, capture a local grid, draft content and pitches, publish to your CMS, decide approvals, send outreach, convert a prospect to a client, ask the Agent.
  • Onboard and pitch: add a client, a location or a set of prompts; start a client's first measurement when it was never measured; promote a prospect to a pitch and read its stored contact (never one on your do not contact list); submit a draft for a person's approval.

The confirmation step

Any tool that spends budget or cannot be undone pauses on the first call. It returns a plain summary of what is about to happen plus a short-lived confirmation token bound to your workspace, that tool, and those exact arguments. Calling again with the token executes it. This is the agent version of the console's two click confirm. The agent sends the token back itself, so the step stops a slip, not an agent you authorised.

> send_outreach_pitch (brandId, targetId)
CONFIRMATION REQUIRED (this is irreversible).
SEND the drafted pitch from the org's connected Gmail. This emails a real
person and cannot be unsent.
Call again with the SAME arguments plus confirmToken. Expires in 10 minutes.

> send_outreach_pitch (brandId, targetId, confirmToken)
Sent from your Gmail. Status: sent.
Know this

A token minted for one action cannot execute another: it is bound to the exact arguments. Admin-only actions (sending mail, approving a placement) require an admin seat's key. Billing is deliberately not on the MCP surface.