Website analytics

Count more events

analytics_add_events · Changes data · Markdown

Raises a site's monthly event allowance by blocks of a million events.

$5.00 per block of a million events a month

From your agent’s balance. A call that fails costs nothing.

An example

The Black Friday sale will push the website past its allowance. Add another million events a month.

Your agent callsanalytics_add_events$5.00 per block of a million events a month

The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.

With these arguments
{
  "site": "halversoncycle.example",
  "blocks": 1
}
What comes back
{
  "site": {
    "site_id": "031adbb6-78ea-4705-aac0-b0589d4f5aac",
    "domain": "halversoncycle.example",
    "name": "Halverson Cycle & Repair",
    "time_zone": "America/Los_Angeles",
    "snippet": "<script defer src=\"https://cncto.co/a.js\" data-site=\"031adbb6-78ea-4705-aac0-b0589d4f5aac\"></script>",
    "events_this_month": 13,
    "clicks_this_month": 0,
    "allowance_per_month": 1100000,
    "extra_blocks": 1,
    "monthly_usd": "$8.00",
    "goals": [],
    "events": [],
    "spike_alert_visitors": null,
    "weekly_summary": false,
    "track_errors": false,
    "keep_sources": true,
    "created_at": "2026-10-14T08:00:00+00:00"
  }
}

Use it when

A site is near its monthly allowance; above it, events are counted but not stored.

What it does

Raise a site's monthly allowance by blocks of a million events at $5 a month each, renewed from the balance; this call pays the first month of the new blocks. Above the allowance, events are counted but not stored.

What comes back

The site with its new allowance per month, extra blocks and monthly price. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
siteRequiredstringThe site's domain (e.g. halversoncycle.example) or its site_id. 4 to 253 characters.
blocksRequiredinteger1 to 20.

The call

Over MCP, call analytics_add_events on https://api.conecto.chat/mcp/analytics. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/analytics_add_events \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"site":"halversoncycle.example","blocks":1}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
not_found404No site the business counts has that domain or site_id.Call analytics_list_sites and use a domain from it.
limit_reached409The site already has as many extra blocks as it may.Keep the blocks it has; events above the allowance are still counted, only not stored.

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md