Tracker MCP tools

Eight MCP tools to create weekly or monthly trackers, confirm the per-run cost, run them manually, read stored results and delete inactive ones.

Tracker lifecycle

A tracker runs 1–30 prompts weekly or monthly for one measurement: rankings, compare, citations, or sentiment. Each prompt is billed per run. Drafts are free; cite42_map_ai_prompts can prepare the prompt list.

To activate, confirm the exact estimatedCostMicroPerRun as maxCostMicroPerRun. A changed estimate needs fresh approval. Runs continue until paused.

Create a tracker in chat

# you say
Create a weekly visibility tracker for Acme CRM.
Name it “Acme CRM weekly visibility”.
Track rankings for Acme CRM, Rival CRM, and Legacy CRM on these prompts:
- best startup CRM
- Which startup CRM is quickest to set up?
- What CRM should a small sales team use?
Run every Monday at 09:00 Europe/London.
Show me the cost, but do not activate it.
View draft tool JSON
{
  "tracker": {
    "id": "6d9d6580-4cef-4b84-8804-2e90d9e57c9a",
    "name": "Acme CRM weekly visibility",
    "status": "DRAFT",
    "cadence": {
      "frequency": "weekly",
      "timezone": "Europe/London",
      "time": "09:00",
      "weekday": 1
    },
    "primitive": "rankings",
    "prompts": [
      "best startup CRM",
      "Which startup CRM is quickest to set up?",
      "What CRM should a small sales team use?"
    ],
    "brand": null,
    "competitors": [
      "Acme CRM",
      "Rival CRM",
      "Legacy CRM"
    ],
    "url": null,
    "models": [
      "chatgpt",
      "perplexity",
      "gemini"
    ],
    "estimatedCostMicroPerRun": 39000,
    "maxCostMicroPerRun": null,
    "nextRunAt": null,
    "lastRunAt": null,
    "pauseReason": null,
    "createdAt": "2026-08-17T08:30:00.000Z",
    "updatedAt": "2026-08-17T08:30:00.000Z"
  }
}
# your AI replies
Draft created. 3 prompts across three AI surfaces, so the current estimate is $0.39 per run.
Nothing is scheduled yet. Approve that exact amount as the maximum per run to activate it.
# you say
Activate Acme CRM weekly visibility with a maximum of $0.39 per run.

# your AI replies
The tracker is Active. It will run every Monday at 09:00 Europe/London while active.
If a future estimate exceeds the approved maximum, Cite42 pauses it before another provider call.
View activation tool JSON
{
  "trackerId": "6d9d6580-4cef-4b84-8804-2e90d9e57c9a",
  "maxCostMicroPerRun": 39000
}

The eight tools

cite42_tracker_create
Save a free Draft; no runs start.
cite42_tracker_update
Replace the full definition; return to Draft.
cite42_tracker_activate
Confirm the current per-run maximum and start or resume. Requires enough balance for one run.
cite42_tracker_pause
Stop scheduled runs; keep configuration and history.
cite42_tracker_delete
Remove a Draft or Paused tracker and its history after active runs finish.
cite42_tracker_run
Queue one billed manual run; reuse its request token only for retries.
cite42_trackers
List status, configuration, schedule and cost estimates for free.
cite42_tracker_report
Read stored results and costs for free: 8 runs by default, up to 20.

Billing & confirmation

Management and history reads are free. Scheduled and manual runs bill successful saved calls. Activation authorizes recurring charges until pause; use cite42_trackers to re-read the estimate and cite42_pricing for current rates.

More prompts

# create and review a draft without starting calls
Create separate weekly trackers for our rankings, competitor comparison, citations, and sentiment. Show each cost-per-run estimate, but leave them as drafts.

# explicit confirmation before recurring billing
Re-read that tracker's current estimate and ask me to approve the exact maximum before you activate its recurring runs.

# free stored-history read
Show me the last 10 runs for our weekly visibility tracker and summarize the biggest ranking, citation, and sentiment changes.