AgentFirstStack Tags

Registre officiel Marketing et ventes

Tag manager with server-side conversions for GA4, Google Ads, Meta and TikTok, set up by an agent.

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code
claude mcp add --transport http agentfirststack-tags 'https://tags.agentfirststack.com/mcp' --header 'Authorization: <Bearer <API key> from one POST https://agentfirststack.com/v1/signup (no signup form). OAuth also works.>'
Configuration JSON (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "agentfirststack-tags": {
            "type": "http",
            "url": "https://tags.agentfirststack.com/mcp",
            "headers": {
                "Authorization": "<Bearer <API key> from one POST https://agentfirststack.com/v1/signup (no signup form). OAuth also works.>"
            }
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. AgentFirstStack
  2. Services
  3. Quick start
  4. How it's built
  5. Development
  6. Contributing
  7. License

AgentFirstStack

Analytics, tag management, email inboxes and session replay that an AI agent sets up by itself.

No signup form, no verification email, no dashboard to click through. Free to use, and open source.

agentfirststack.com · Manual · Self-host · Architecture


Every new website needs the same infrastructure: analytics, a tag manager with conversion tracking, and an email address to sign up for everything else. The usual tools all start with a signup form, a verification email and a dashboard. Coding agents can't get past those steps alone.

AgentFirstStack is that infrastructure, rebuilt so an agent can do the whole job:

  • One request gets an account. POST /v1/signup returns a key that works on every service.
  • Everything is an API call and an MCP tool. Nothing is hidden behind a settings page.
  • The manual is a text file. Each service serves /llms.txt with every endpoint, tool and field.
  • Every step can be verified. The agent checks its own work instead of guessing.
  • Humans optional. When it's done, the agent hands its person a claim link. They sign in with Google to see the project in a dashboard, manage keys and teammates, and connect Claude or ChatGPT over OAuth (docs/accounts.md).

Services

What it doesInstead of
AnalyticsCookieless web analytics. Country, region and city from Cloudflare's edge; channels including AI assistants; UTM and ad click ids; goals, revenue, funnels, realtime; server-side events; read-only SQLGoogle Analytics, Plausible
TagsA tag manager and server-side conversion router. Define a conversion once; the browser pixel and the server both send it to GA4, Google Ads, Meta and TikTok with one event id, so each platform counts it once. Scan, validate, preview, test and publishGoogle Tag Manager, server-side GTM
MailInboxes in one request. wait_for_email returns the moment a message arrives, with verification codes and links already extracted. Read, reply, send, custom domains, webhooksA Gmail account per project, AgentMail
ReplaySession recordings masked in the browser by default. Sessions come back as readable transcripts; rage, dead and error clicks, heatmaps and JS errors as data; a share link opens a player for peopleHotjar, Microsoft Clarity

Quick start

Hosted (free)

Copy the prompt from agentfirststack.com into Claude Code, Cursor, Codex or any agent that can make HTTP requests. Or do it by hand:

curl -X POST https://agentfirststack.com/v1/signup
# { "api_key": "afs_...", "mcp": { ... }, "next_steps": [ ... ] }

curl -X POST https://analytics.agentfirststack.com/v1/sites \
  -H "Authorization: Bearer $AGENTFIRSTSTACK_API_KEY" -H 'content-type: application/json' \
  -d '{"domain":"example.com"}'

Add one MCP server for every service (tools prefixed analytics_, tags_, mail_, replay_):

claude mcp add --transport http afs https://agentfirststack.com/mcp --header "Authorization: Bearer $AGENTFIRSTSTACK_API_KEY"

Or one per service:

claude mcp add --transport http afs-analytics https://analytics.agentfirststack.com/mcp --header "Authorization: Bearer $AGENTFIRSTSTACK_API_KEY"
claude mcp add --transport http afs-tags https://tags.agentfirststack.com/mcp --header "Authorization: Bearer $AGENTFIRSTSTACK_API_KEY"
claude mcp add --transport http afs-mail https://mail.agentfirststack.com/mcp --header "Authorization: Bearer $AGENTFIRSTSTACK_API_KEY"
claude mcp add --transport http afs-replay https://replay.agentfirststack.com/mcp --header "Authorization: Bearer $AGENTFIRSTSTACK_API_KEY"

The hosted version has fair-use limits, listed in the manual.

Self-hosted

Everything runs on Cloudflare Workers in your own account:

git clone https://github.com/StartGlobal-AI/agentfirststack && cd agentfirststack
pnpm install
pnpm afs init mystack --domain example.com --account <cloudflare-account-id>
pnpm afs deploy mystack
CLOUDFLARE_API_TOKEN=... pnpm afs email mystack     # inbound + outbound mail
pnpm afs check mystack

See docs/self-hosting.md for requirements, signup modes, limits and updates.

How it's built

TypeScript on Cloudflare Workers with Hono and zod. Storage:

  • D1: configuration and the shared identity database.
  • SQLite Durable Objects: hot per-entity data (a site's events, a container's visitors, an inbox's waiters).
  • R2: mail blobs and replay recording chunks.
  • Queues: retried delivery to ad platforms and webhooks.
  • Email Routing and Email Sending: mail in and out.
site/        landing page, platform manual, platform signup      agentfirststack.com
analytics/   web analytics                                        analytics.agentfirststack.com
tags/        tag manager + conversion APIs                        tags.agentfirststack.com
mail/        inboxes, sending, domains, webhooks                  mail.agentfirststack.com
replay/      session replay, signals, heatmaps, share player          replay.agentfirststack.com
shared/      @afs/shared: auth, signup, errors, MCP handler
scripts/     pnpm afs: the deployment tool
deploy/      deployment profiles (yours; the agentfirststack.com one is kept private)
docs/        architecture, self-hosting, operations, development

More in docs/architecture.md.

Development

pnpm install
pnpm typecheck && pnpm test          # every package; integration tests run inside workerd
cd mail && pnpm db:migrate:local && pnpm dev

docs/development.md covers running services locally, tests, and adding endpoints, migrations and tag destinations. docs/operations.md covers releases, migrations, secrets, monitoring and abuse handling for a running deployment.

Contributing

Issues and pull requests are welcome. Read CONTRIBUTING.md first; it's short. Report security issues privately as described in SECURITY.md.

License

MIT. Built and hosted by StartGlobal.

Questions fréquentes

Qu'est-ce que AgentFirstStack Tags ?

Tag manager with server-side conversions for GA4, Google Ads, Meta and TikTok, set up by an agent.

Comment installer AgentFirstStack Tags ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http agentfirststack-tags 'https://tags.agentfirststack.com/mcp' --header 'Authorization: <Bearer <API key> from one POST https://agentfirststack.com/v1/signup (no signup form). OAuth also works.>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour AgentFirstStack Tags ?

Oui. Il attend Authorization, à renseigner dans sa configuration.

AgentFirstStack Tags est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient AgentFirstStack Tags ?

Il est publié par StartGlobal-AI. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.