cogny clianalyticsfirst 15 calls free

simple analytics queried from the terminal.

List websites, pull aggregate stats, top pages, and top referrers, and read custom event stats over any date range — all from Bash over the Simple Analytics MCP. Privacy-first analytics without opening the dashboard.

1. sign up, free for the first calls (uses your git email)npx @cogny/cli init --agent claude-code
2. see every Simple Analytics toolcogny tools list
3. call any tool from bash, no MCP wiringcogny tools call mcp__Simple_Analytics__stats --input '{…}'

Start free @cogny/cli on npm

01two paths

you're a person

Simple Analytics keeps a clean, cookie-free dashboard, but answering "which pages and referrers moved last week" still means clicking around and eyeballing. The CLI returns those breakdowns as JSON you can diff week over week, schedule, or pass to an agent. Connect Simple Analytics once in Cogny Solo and let your coding agent, or a scheduled loop, do the querying for you.

Start Solo

you're an agent

Sign yourself up with one command. The CLI issues a key, wires nothing, and exposes every Simple Analytics tool over JSON-RPC. The first 15 calls are free.

npx @cogny/cli init --agent claude-code

02tools call

real Simple Analytics tools.

Tool names as the Simple Analytics MCP serves them. Send --input JSON, get JSON back. The payloads are illustrative.

mcp__Simple_Analytics__stats
Aggregate pageviews and visitors for a site over a range.
- cogny tools call mcp__Simple_Analytics__stats \ --input '{"hostname":"example.com","start":"2026-06-01","end":"2026-06-14"}'
example response
```
{
  "pageviews": 41200,
  "visitors": 18044,
  "histogram": [
    {
      "date": "2026-06-01",
      "pageviews": 2810,
      "visitors": 1240
    }
  ]
}
```

mcp__Simple_Analytics__pages

Top pages by pageviews for a site.

cogny tools call mcp__Simple_Analytics__pages \ --input '{"hostname":"example.com","start":"2026-06-01","end":"2026-06-14","limit":3}'

example response

{
  "pages": [
    {
      "value": "/",
      "pageviews": 12044,
      "visitors": 7120
    },
    {
      "value": "/pricing",
      "pageviews": 5310,
      "visitors": 3880
    },
    {
      "value": "/blog/new-post",
      "pageviews": 2188,
      "visitors": 1944
    }
  ]
}

mcp__Simple_Analytics__referrers

Top referrer sources for a site.

cogny tools call mcp__Simple_Analytics__referrers \ --input '{"hostname":"example.com","start":"2026-06-01","end":"2026-06-14","limit":3}'

example response

{
  "referrers": [
    {
      "value": "google.com",
      "pageviews": 8120,
      "visitors": 5440
    },
    {
      "value": "twitter.com",
      "pageviews": 1880,
      "visitors": 1210
    },
    {
      "value": "news.ycombinator.com",
      "pageviews": 940,
      "visitors": 760
    }
  ]
}

03tools list

the rest of the surface.

A sample of the other Simple Analytics tools. Run cogny tools list --json for every tool and its input schema.

mcp__Simple_Analytics__list_websites
mcp__Simple_Analytics__events

04then a verdict

calls from a script. verdicts from cogny.

Every write is logged with who authorised it. Launches your agent makes (a new campaign, a new ad) become measured tickets automatically; for other changes, your agent offers to register them. Cogny measures each in your own data, three days later for ads and seven for content and SEO, and closes it as worked, partial, didn't work or inconclusive.

worked
Moved the number. Every measured win has a share card.
partial
Some of it did.
didn't work
On the record anyway, so it isn't proposed again.
inconclusive
Not enough data to call.

How the loop works

05questions

questions.

Is this an official Simple Analytics CLI?: No — it is the Cogny CLI calling the Simple Analytics MCP over the cogny-mcp-proxy. You connect your Simple Analytics credential once in Cogny and then call every tool from Bash with no API client to maintain.
What date inputs do the tools accept?: start / end accept ISO dates (YYYY-MM-DD) or relative values the API supports, like "today" and "yesterday". pages, referrers, and events take a limit to cap rows.
Does it expose custom events?: Yes — events returns custom event stats for a site over the date range, alongside the page and referrer breakdowns. Everything is aggregate and cookie-free by design.

06related

Building an agent? The full tool map for every server is one fetch: /cli/llms.txt

simple analytics, then a verdict.

Start free All CLIs