Quickstart

From zero to your first answer in a few minutes.

1. Create your account

Go to app.pulse.pulsecircle.studio and sign in with GitHub or a one-time email link — no password.

2. Create your app

Name your app and pick a platform. You’ll get an API key, shown once — copy it now (we only store a hash). You can rotate it later in Settings.

3. Add Pulse — let your AI agent do it

The fastest path: paste this to your AI coding agent (Claude Code, Cursor, …). It reads our llms.txt and installs and wires the SDK for you:

Install Pulse analytics in this project.
Read the docs first: https://pulse.pulsecircle.studio/llms.txt
Use the @pulse-circle/web package with API key YOUR_PULSE_API_KEY.
Initialize Pulse with the key and send a "signup_completed" test event.

4. …or add the SDK yourself

Web app (browser) — a ~10 KB, zero-dependency SDK:

npm i @pulse-circle/web

import { Pulse } from '@pulse-circle/web';

Pulse.init('YOUR_PULSE_API_KEY');
Pulse.track('signup_completed', { plan: 'pro' });
Pulse.identify('user_42'); // after login

Or drop in a script tag (exposes a global Pulse):

<script src="https://cdn.jsdelivr.net/npm/@pulse-circle/web/dist/pulse.iife.global.js"></script>

No SDK, or a backend? POST straight to the ingestion API:

curl -X POST https://api.pulse.pulsecircle.studio/v1/batch \
  -H "Authorization: Bearer YOUR_PULSE_API_KEY" \
  -H "content-type: application/json" \
  -d '{"batch":[{"event":"app_open","anonymous_id":"device-123",
        "timestamp":"2026-07-06T10:00:00Z","idempotency_key":"evt-1"}]}'

Each item needs an event, a user identifier (anonymous_id oruser_id), a timestamp, and an idempotency_key so retries never double-count. Call /v1/identify to link an anonymous device to a known user.

Native apps? Your AI agent generates the exact snippet for Swift, Kotlin or React Native via the MCP pulse_setup_guide tool — see MCP server.

5. Connect your data & ask

Link your revenue and ad tools in Connections, then ask Pulse in the web chat or the Telegram Mini App: “How’s MRR trending?”, “Which campaign has the best LTV to CAC?”, “Did anything unusual happen this week?”.