# Pixel API

> Consent-first website pixel for agents. The snippet from configure_consent shows a consent bar that asks each visitor to "identify this visit," and each acceptance is stored with the policy hash and origin. Public contract for signup, setup, consent, and contacts. Operator routes are omitted.

Agents: load /docs.json once. People: open /connect for client setup or /docs for API contracts.

## Connect and tasks

- [Connection hub](/connect): Cursor and VS Code setup, account steps and task guides
- [Connection catalog](/connect.json): public machine-readable server and client configuration
- [Identify consented visitors](/guides/consented-visitor-identity.md): account setup and identity limits
- [Install consent pixel](/guides/consent-pixel-installation.md): configure and verify a site tag
- [Read stored contacts](/guides/consented-contact-export.md): UTC day or cursor retrieval
- [Add a website pixel with Claude Code](/guides/claude-code-website-pixel.md): one command, then ask Claude
- [Add a website pixel in Cursor](/guides/cursor-website-pixel.md): install link, then ask the agent
- [Consent-first visitor identification](/guides/consent-first-visitor-identification.md): what is asked, stored and skipped

## Try it without an account

- [Sample output](/v1/sample): labeled synthetic pixel, consent receipt and contacts. MCP tool: try_sample

## Lessons

- [Signup](/docs/signup.md): Start a 30-day trial, no card, confirm the email with a 6-digit code, and take an API key. After the trial subscribe for $1 per account/month. Includes 3 pixels and 500 new contacts per UTC calendar month. No extra charges. Resolution pauses at the limit or until subscribed.
- [Setup](/docs/setup.md): Mint a pixel, paste the tag, and confirm the homepage contains it.
- [Contacts](/docs/contacts.md): Pull resolved people by UTC day or by the last id you have.
- [Consent](/docs/consent.md): Turn on the permission popup, then read and verify receipts.
- [Evaluate AgentPixel safely](/docs/evaluation.md): Private scoped evaluation with consent and labeled synthetic examples.
- [Endpoints](/docs/endpoints.md): Every non-operator route

## Machine

- [Catalog](/docs.json): lessons and endpoint contracts in one JSON document
- [OpenAPI](/openapi.json): generated schema, thinner than the catalog

## Discovery

- [MCP server card](/.well-known/mcp/server-card.json): tools, auth and transport for scanners
- [MCP registry manifest](/server.json): io.agentpixel/agentpixel
- [Install links](/connect): Cursor, VS Code, Claude Code, Gemini CLI
- MCP endpoint: https://agentpixel.io/mcp (streamable HTTP; add ?src=<directory> to say where you found it)