> For the complete documentation index, see [llms.txt](https://docs.humblytics.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.humblytics.com/how-to-get-started/set-up-with-your-ai-agent.md).

# Set up with your AI agent

Connect Claude, ChatGPT, Codex, Cursor or any MCP app. Your agent signs you up, adds your site, installs the script and runs setup. The first 5,000 data points are free, no card.

Humblytics is agent-first. You connect your AI agent and it does the setup. From just your email and your site, it signs you up, adds your site, installs the tracking script and checks that data is coming in. You click one button in one email.

It works with Claude, ChatGPT, Claude Code, Codex, Cursor and any app that supports MCP.

**You need:**

* A live website, and access to its code or site builder.
* An AI agent that supports MCP.

No card is needed. The first 5,000 data points and 1 site are free.

***

## Step 1: Give your agent your email and site

Paste this into your agent:

```
Read https://app.humblytics.com/agent.md and set up Humblytics on mysite.com for you@example.com.
```

Humblytics sends you one email: "Your agent wants to set up Humblytics on mysite.com". Click **Activate**, then **Activate** again on the page it opens. That one click:

* creates your free account, or uses the one you already have;
* adds your site;
* saves your homepage audit and its drafted tests, if you started from one;
* gives your agent its key, so it carries on with the setup.

There is no sign-in page and no code to type. The link lasts 24 hours. If you didn't ask for it, ignore the email and nothing is created.

{% hint style="info" %}
**Prefer to sign up yourself, or using a chat app?** Claude and ChatGPT chat apps can't run the step above. Go to [humblytics.com](https://humblytics.com) and sign up, or open [app.humblytics.com/auth](https://app.humblytics.com/auth). Sign up with Google or your email (email sign-up sends a six-digit code; there is no password), choose **agent**, then connect your app in Step 2.
{% endhint %}

{% hint style="info" %}
**Already signed up and see a plan picker?** If your account has no plan yet, the plan picker also offers **Or set it up with your AI agent · free, no card**. Choose it to start on the Free start and go straight to connecting your agent. No payment is needed.
{% endhint %}

***

## Step 2: Connect your agent

The quickest way is the setup prompt. In the app, open **Agents** (or choose the agent path during sign-up), click **Copy setup prompt** and paste it into your agent. It tells the agent to connect the Humblytics MCP server and sign in to your account. If you came from a website audit, the prompt also names your audited site and test 1. Your agent asks before it publishes anything.

If you would rather do it by hand, use the options below. If you are not ready to connect an agent, choose **Skip for now** to open your dashboard (or **Set it up in the app instead** during onboarding).

The Humblytics MCP server is `https://mcp.humblytics.com/v1` (Streamable HTTP). It is included on every plan, the free start too.

**Claude** (web and desktop): add the [Humblytics connector](https://claude.ai/directory/connectors/humblytics-mcp), click **Connect**, sign in and approve access.

**ChatGPT**: add a custom connector with this URL:

```
https://mcp.humblytics.com/v1/chatgpt
```

**Claude Code**: run:

```bash
claude mcp add --transport http humblytics https://mcp.humblytics.com/v1
```

**Cursor**: click **Add to Cursor** in the app, or add a remote MCP server with this URL. **Codex and other MCP apps**: add a remote MCP server with the same URL:

```
https://mcp.humblytics.com/v1
```

Apps that support MCP sign-in open a Humblytics page where you approve access. There is no key to paste. If your app cannot sign in this way, create an account API key on the **Agents** page (**API keys** tab) in the app and send it as `Authorization: Bearer <key>`.

***

### Copy the setup prompt

After you choose your agent, the app shows a setup prompt to copy. Paste it into your agent.

* The prompt carries a **link code** that ties your agent to the account you are signed in with. The code is valid for 15 minutes and refreshes while the screen is open.
* The screen moves on by itself once your agent connects. You do not need to click anything.
* If no agent connects within 2 minutes, the screen shows **Agent not connected yet**. Check that the agent has the Humblytics MCP server and that you pasted the whole prompt.
* If the code expired or was already used, the screen shows **Link code expired**. Click **Make a fresh prompt** and paste the new one. Your account and site are kept.

***

## Step 3: Let your agent run setup

Ask your agent: "Set up Humblytics for mysite.com."

The agent then:

1. Checks your account.
2. Adds your site. If the site does not load, it tells you before it installs anything.
3. Installs the tracking script in the `<head>` of every page. With access to your code, it works on a branch and opens a pull request. With Webflow or Framer MCP access, it adds the script in site settings. Otherwise it tells you exactly where to paste it.
4. Checks that tracking is live. If it is waiting for the first pageview, open your site once.

While the agent works, the app shows a live **Setting up** checklist. Each row turns green as the agent finishes it. When setup is done, the app shows **Site live**. If your first test is already drafted, it shows **Test 1 ready** or **Test 1 running**. A running test says **Too early to call** and stops by itself after 30 days.

Your agent asks you before it publishes your site, merges code, launches an A/B test or buys anything.

***

## Step 4: Ask questions

Once data comes in, ask your agent what you want to know. For example:

* "Which pages get the most traffic this week?"
* "Where do visitors drop off before they book a demo?"
* "What should I A/B test on my pricing page?"

Reading data never uses data points.

***

## Data points and pricing

A **data point** is one tracked event: a pageview, click, form submission, custom event or revenue event. Reads, questions and tool calls are not counted.

| Plan           | Price                            | What you get                                                                                             |
| -------------- | -------------------------------- | -------------------------------------------------------------------------------------------------------- |
| **Free start** | $0, no card                      | The first 5,000 data points and 1 site                                                                   |
| **Agents**     | $39 one time, not a subscription | 100,000 data points, valid 12 months, unlimited sites. Top-ups are $29 per 100,000.                      |
| **Business**   | $79/month                        | Team plan with the full app. 14-day free trial with card.                                                |
| **Scale**      | $279/month                       | Team plan with the full app. 14-day free trial with card. Extra data points are $39 per extra 1 million. |

When your data points run out, tracking pauses until you buy more. Your collected data stays, and your agent can still read it.

Your agent can get you a checkout link for the Agents plan. You pay in your browser.

***

## Related

* [API Access & Agent Setup](https://docs.humblytics.com/api-access-and-agents.md)
* [Verify & Troubleshoot Tracking](https://docs.humblytics.com/how-to-get-started/verify-and-troubleshoot-tracking.md)
* [Frequently Asked Questions](https://docs.humblytics.com/frequently-asked-questions.md)
