# Clicsdev

> Agent skills for Clics: privacy-friendly, cookieless web analytics. MCP server and CLI for AI assistants.

- **Type:** MCP server
- **Install:** `agentstack add mcp-p-essonam-clicsdev`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [P-Essonam](https://agentstack.voostack.com/s/p-essonam)
- **Installs:** 0
- **Category:** [Data & Analytics](https://agentstack.voostack.com/c/data-and-analytics)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [P-Essonam](https://github.com/P-Essonam)
- **Source:** https://github.com/P-Essonam/clicsdev
- **Website:** https://clics.dev

## Install

```sh
agentstack add mcp-p-essonam-clicsdev
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Clics

Privacy-friendly, cookieless web analytics — built for teams that want GDPR-friendly measurement without tracking cookies.

- **Website:** [clics.dev](https://clics.dev)
- **Dashboard:** [platform.clics.dev](https://platform.clics.dev)
- **Docs:** [clics.dev/docs](https://clics.dev/docs)

Clics measures traffic, goals, and funnels on your sites. This repository distributes **agent-facing tooling** so AI assistants can query analytics and manage your workspace from the terminal, a local MCP client, or a web-based assistant.

## What you get

| Tool | Package / endpoint | Best for |
|------|-------------------|----------|
| **Remote MCP** | Hosted endpoint (see below) | ChatGPT, Claude.ai, n8n, and other HTTP MCP clients |
| **Local MCP** | [`@clicsdev/mcp`](https://www.npmjs.com/package/@clicsdev/mcp) | Cursor, Claude Code, VS Code, Windsurf, and other stdio MCP clients |
| **CLI** | [`@clicsdev/cli`](https://www.npmjs.com/package/@clicsdev/cli) | Scripts, CI, and manual verification from the terminal |
| **Agent skill** | this repo | Teaching agents when and how to use Clics MCP + CLI |

Create an API key in the [dashboard](https://platform.clics.dev).

---

## Remote MCP

Hosted [Model Context Protocol](https://modelcontextprotocol.io) server over HTTP Streamable. Use this when your assistant runs in the browser or in a workflow tool and cannot run a local `npx` process.

**Endpoint** (replace `YOUR_API_KEY` with your Clics API key):

```
https://api.clics.dev/YOUR_API_KEY/v1/mcp
```

The API key is embedded in the URL. Set authentication to **None** in the client; no extra headers are required.

**Tools:** same 15 tools as local MCP (`list_projects`, `get_project`, `create_project`, `update_project`, `delete_project`, `list_goals`, `create_goal`, `update_goal`, `delete_goal`, `list_funnels`, `get_funnel`, `create_funnel`, `update_funnel`, `delete_funnel`, `query_stats`).

### ChatGPT

1. Create an API key in the [dashboard](https://platform.clics.dev).
2. In ChatGPT, open **Settings** → **Advanced Settings** and enable **Developer mode**.
3. Open **Apps & Connectors** → **Create**.
4. Fill in:
   - **Name:** `Clics MCP`
   - **MCP Server URL:** `https://api.clics.dev/YOUR_API_KEY/v1/mcp`
   - **Authentication:** `None`
5. Save and enable the connector in a conversation.

### Claude.ai

1. Create an API key in the [dashboard](https://platform.clics.dev).
2. Go to **Settings** → **Connectors** → **Add custom connector**.
3. Set **URL** to `https://api.clics.dev/YOUR_API_KEY/v1/mcp` (leave OAuth fields blank).
4. In a conversation, enable the connector from **Connectors**.

### n8n

1. Create an API key in the [dashboard](https://platform.clics.dev).
2. In your workflow, add an **AI Agent** node.
3. Add a tool → **MCP Client Tool**.
4. Configure:
   - **Endpoint:** `https://api.clics.dev/YOUR_API_KEY/v1/mcp`
   - **Server Transport:** `HTTP Streamable`
   - **Authentication:** `None`
5. Choose which tools to expose (All, Selected, or All Except).

---

## Local MCP (`@clicsdev/mcp`)

Local [Model Context Protocol](https://modelcontextprotocol.io) server (stdio) for cookie-free analytics. Manage projects, goals, funnels, and query stats from your editor when it can run a local process.

**Install**

```bash
npm install -g @clicsdev/mcp
# or: npx -y @clicsdev/mcp
```

**Authenticate** — set `CLICS_API_KEY` in your MCP client config (never pass the key as a tool argument).

**Cursor** (`.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "clics": {
      "command": "npx",
      "args": ["-y", "@clicsdev/mcp"],
      "env": {
        "CLICS_API_KEY": "your_api_key"
      }
    }
  }
}
```

**Tools:** `list_projects`, `get_project`, `create_project`, `update_project`, `delete_project`, `list_goals`, `create_goal`, `update_goal`, `delete_goal`, `list_funnels`, `get_funnel`, `create_funnel`, `update_funnel`, `delete_funnel`, `query_stats`.

Full client setup: [npm/@clicsdev/mcp](https://www.npmjs.com/package/@clicsdev/mcp)

---

## CLI (`@clicsdev/cli`)

Command-line interface for the same operations — JSON on stdout, ideal for automation and quick checks.

**Install**

```bash
npm install -g @clicsdev/cli
# or: npx @clicsdev/cli --help
```

**Authenticate**

```bash
clics init --api-key ""
```

**Examples**

```bash
clics projects list
clics goals list 
clics query  --metrics visitors pageviews bounce_rate --date-range last30days
```

Full command reference: [npm/@clicsdev/cli](https://www.npmjs.com/package/@clicsdev/cli)

---

## Agent skill

The `clics` skill teaches agents to prefer MCP when connected, fall back to CLI when not, and follow analytics playbooks (overview, top pages/countries, goals/funnels).

**Install** with the [skills CLI](https://github.com/vercel-labs/skills):

```bash
npx skills add P-Essonam/clicsdev --skill clics
```

Global install (all projects):

```bash
npx skills add P-Essonam/clicsdev --skill clics -g -y
```

List skills without installing:

```bash
npx skills add P-Essonam/clicsdev --list
```

Skill source: [`skills/clics/SKILL.md`](skills/clics/SKILL.md)

---

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [P-Essonam](https://github.com/P-Essonam)
- **Source:** [P-Essonam/clicsdev](https://github.com/P-Essonam/clicsdev)
- **License:** MIT
- **Homepage:** https://clics.dev

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-p-essonam-clicsdev
- Seller: https://agentstack.voostack.com/s/p-essonam
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.