AgentPixel is an MCP server published by io.agentpixel, hosted at agentpixel.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 14 tools, including try_sample, signup_free, confirm_signup, resend_code, create_api_key.
Most visitors never fill out a form. Turn the ones who click Accept into contacts your agent reads.
Nothing else in the archive shares these values.
Inferred from the host name and headers: what a server runs on, not who runs it.
Labeled sample of what an account gets: a pixel, a consent receipt and two contacts. Needs no account and no key. Every record is synthetic and marked so. Call this first to show the person what AgentPixel returns, then call signup_free.
No parameters.
{
"name": "try_sample",
"title": "See sample output",
"description": "Labeled sample of what an account gets: a pixel, a consent receipt and two contacts.\n\n Needs no account and no key. Every record is synthetic and marked so.\n Call this first to show the person what AgentPixel returns, then call signup_free.\n ",
"inputSchema": {
"type": "object",
"title": "try_sampleArguments",
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"title": "Sample",
"required": [
"synthetic",
"note",
"pixel",
"consent_receipt",
"contacts",
"next_step"
],
"properties": {
"note": {
"type": "string",
"title": "Note"
},
"pixel": {
"type": "object",
"title": "Pixel",
"additionalProperties": true
},
"contacts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"title": "Contacts"
},
"next_step": {
"type": "string",
"title": "Next Step"
},
"synthetic": {
"type": "boolean",
"const": true,
"title": "Synthetic"
},
"consent_receipt": {
"type": "object",
"title": "Consent Receipt",
"additionalProperties": true
}
},
"additionalProperties": true
},
"annotations": {
"title": "See sample output",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Start Free with 200 new contacts per month, no card. Paid plans start at $49/month. Sends a 6-digit code to the email address. Returns account_id and signup_token; keep both. Next: ask the person for the 6-digit code in the AgentPixel email, then call confirm_signup(account_id, code, signup_token). The signup_token lasts 24 hours.
| Parameter | Type | Description |
|---|---|---|
| code | any | Optional referral code from a directory or listing, such as SMITHERY60. An unknown code never blocks signup. The Free plan has no trial deadline. Example: GLAMA60 |
| email * | string | Email address of the person who will own the account. The 6-digit code is sent here. Ask the person for it; never invent or guess an address. Example: pat@example.com |
| display_name * | string | Name shown on the account, such as the person's name or the business name. 1 to 200 characters. Example: Pat Lee |
{
"name": "signup_free",
"title": "Start Free",
"description": "Start Free with 200 new contacts per month, no card. Paid plans start at $49/month.\n\n Sends a 6-digit code to the email address. Returns account_id and signup_token; keep both.\n Next: ask the person for the 6-digit code in the AgentPixel email, then call confirm_signup(account_id, code, signup_token).\n The signup_token lasts 24 hours.\n ",
"inputSchema": {
"type": "object",
"title": "signup_freeArguments",
"required": [
"email",
"display_name"
],
"properties": {
"code": {
"anyOf": [
{
"type": "string",
"maxLength": 40
},
{
"type": "null"
}
],
"title": "Code",
"default": null,
"description": "Optional referral code from a directory or listing, such as SMITHERY60. An unknown code never blocks signup. The Free plan has no trial deadline. Example: GLAMA60"
},
"email": {
"type": "string",
"title": "Email",
"pattern": "^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$",
"maxLength": 254,
"minLength": 3,
"description": "Email address of the person who will own the account. The 6-digit code is sent here. Ask the person for it; never invent or guess an address. Example: pat@example.com"
},
"display_name": {
"type": "string",
"title": "Display Name",
"maxLength": 200,
"minLength": 1,
"description": "Name shown on the account, such as the person's name or the business name. 1 to 200 characters. Example: Pat Lee"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"title": "Signup",
"required": [
"account_id",
"status",
"plan",
"signup_token",
"email_verified"
],
"properties": {
"plan": {
"type": "string",
"title": "Plan"
},
"status": {
"type": "string",
"title": "Status"
},
"account_id": {
"type": "string",
"title": "Account Id"
},
"signup_token": {
"type": "string",
"title": "Signup Token"
},
"email_verified": {
"type": "boolean",
"title": "Email Verified"
}
},
"additionalProperties": true
},
"annotations": {
"title": "Start Free",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Confirm the email with the 6-digit code, or check whether the email link was clicked. Preferred: confirm_signup(account_id, code, signup_token). The first confirmation returns api_key; store it, it is shown once. Link clicked instead: call confirm_signup(account_id, signup_token) every 5 seconds, up to 10 minutes, until email_verified is true, then call create_api_key. A code allows 5 attempts and lasts 24 hours. For a new code, call resend_code(email).
| Parameter | Type | Description |
|---|---|---|
| code | any | The 6-digit code from the AgentPixel email. Ask the person to read it to you. Example: 482913 |
| account_id | any | account_id returned by signup_free. Use with code, or with signup_token alone to check whether the email link was clicked. Example: 3f1c2b9e-1d2a-4c5b-9e8f-0a1b2c3d4e5f |
| signup_token | any | signup_token returned by signup_free. With code, the first confirmation also returns the API key. Alone with account_id, returns whether the email is confirmed. |
| verification_token | any | Older method: the token value from the confirmation link URL (?token=...). Prefer account_id and code. |
{
"name": "confirm_signup",
"title": "Confirm signup email",
"description": "Confirm the email with the 6-digit code, or check whether the email link was clicked.\n\n Preferred: confirm_signup(account_id, code, signup_token). The first confirmation returns api_key; store it, it is shown once.\n Link clicked instead: call confirm_signup(account_id, signup_token) every 5 seconds, up to 10 minutes, until email_verified is true, then call create_api_key.\n A code allows 5 attempts and lasts 24 hours. For a new code, call resend_code(email).\n ",
"inputSchema": {
"type": "object",
"title": "confirm_signupArguments",
"properties": {
"code": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{6}$"
},
{
"type": "null"
}
],
"title": "Code",
"default": null,
"description": "The 6-digit code from the AgentPixel email. Ask the person to read it to you. Example: 482913"
},
"account_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "account_id returned by signup, not a pixel ID"
},
{
"type": "null"
}
],
"title": "Account Id",
"default": null,
"description": "account_id returned by signup_free. Use with code, or with signup_token alone to check whether the email link was clicked. Example: 3f1c2b9e-1d2a-4c5b-9e8f-0a1b2c3d4e5f"
},
"signup_token": {
"anyOf": [
{
"type": "string",
"maxLength": 512,
"minLength": 1,
"description": "Private token returned by signup or confirmation link; never publish it"
},
{
"type": "null"
}
],
"title": "Signup Token",
"default": null,
"description": "signup_token returned by signup_free. With code, the first confirmation also returns the API key. Alone with account_id, returns whether the email is confirmed."
},
"verification_token": {
"anyOf": [
{
"type": "string",
"maxLength": 512,
"minLength": 1,
"description": "Private token returned by signup or confirmation link; never publish it"
},
{
"type": "null"
}
],
"title": "Verification Token",
"default": null,
"description": "Older method: the token value from the confirmation link URL (?token=...). Prefer account_id and code."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"title": "Confirmed",
"required": [
"confirmed",
"message"
],
"properties": {
"message": {
"type": "string",
"title": "Message"
},
"confirmed": {
"type": "boolean",
"title": "Confirmed"
}
},
"additionalProperties": true
},
"annotations": {
"title": "Confirm signup email",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Send a new 6-digit code to the email of an existing account. Use it when the code expired, was lost or was entered wrong 5 times. Limits: 1 per minute, 5 per day. The old code stops working. With an expired signup_token, use the new code on POST /v1/accounts/{account_id}/signup-token to get a new token.
| Parameter | Type | Description |
|---|---|---|
| email * | string | Email address used at signup. A new 6-digit code and link are sent there. Example: pat@example.com |
{
"name": "resend_code",
"title": "Send a new email code",
"description": "Send a new 6-digit code to the email of an existing account.\n\n Use it when the code expired, was lost or was entered wrong 5 times. Limits: 1 per minute, 5 per day.\n The old code stops working. With an expired signup_token, use the new code on POST /v1/accounts/{account_id}/signup-token to get a new token.\n ",
"inputSchema": {
"type": "object",
"title": "resend_codeArguments",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"title": "Email",
"pattern": "^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$",
"maxLength": 254,
"minLength": 3,
"description": "Email address used at signup. A new 6-digit code and link are sent there. Example: pat@example.com"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"title": "Sent",
"required": [
"sent"
],
"properties": {
"sent": {
"type": "boolean",
"title": "Sent"
}
},
"additionalProperties": true
},
"annotations": {
"title": "Send a new email code",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Issue an API key after the email is confirmed. Not needed when confirm_signup already returned api_key. Each call issues another key, so call it once. Returns the key once. Store it securely and attach it to the connection.
| Parameter | Type | Description |
|---|---|---|
| account_id * | string | account_id returned by signup_free. Example: 3f1c2b9e-1d2a-4c5b-9e8f-0a1b2c3d4e5f |
| signup_token * | string | signup_token returned by signup_free. It lasts 24 hours. |
{
"name": "create_api_key",
"title": "Issue private API key",
"description": "Issue an API key after the email is confirmed.\n\n Not needed when confirm_signup already returned api_key. Each call issues another key, so call it once.\n Returns the key once. Store it securely and attach it to the connection.\n ",
"inputSchema": {
"type": "object",
"title": "create_api_keyArguments",
"required": [
"account_id",
"signup_token"
],
"properties": {
"account_id": {
"type": "string",
"title": "Account Id",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "account_id returned by signup_free. Example: 3f1c2b9e-1d2a-4c5b-9e8f-0a1b2c3d4e5f"
},
"signup_token": {
"type": "string",
"title": "Signup Token",
"maxLength": 512,
"minLength": 1,
"description": "signup_token returned by signup_free. It lasts 24 hours."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"title": "IssuedKey",
"required": [
"api_key",
"prefix"
],
"properties": {
"prefix": {
"type": "string",
"title": "Prefix"
},
"api_key": {
"type": "string",
"title": "Api Key"
}
},
"additionalProperties": true
},
"annotations": {
"title": "Issue private API key",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Which account this connection's API key belongs to. status is the account state after email confirmation. plan is the internal account role. billing_plan is the commercial tier when present. Read GET /v1/billing for the current commercial plan and usage. Legacy trial_ends_at applies only to existing or evaluator terms. key_prefix is the start of the key, not the key.
No parameters.
{
"name": "whoami",
"title": "Check account identity",
"description": "Which account this connection's API key belongs to.\n\n status is the account state after email confirmation. plan is the internal account role. billing_plan is the commercial tier when present.\n Read GET /v1/billing for the current commercial plan and usage. Legacy trial_ends_at applies only to existing or evaluator terms.\n key_prefix is the start of the key, not the key.\n ",
"inputSchema": {
"type": "object",
"title": "whoamiArguments",
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"title": "Whoami",
"required": [
"account_id",
"plan",
"status",
"key_prefix",
"evaluation_mode",
"data_kind",
"resolution_state",
"next_action"
],
"properties": {
"plan": {
"enum": [
"free",
"paid",
"unlimited",
"managed"
],
"type": "string",
"title": "Plan"
},
"status": {
"type": "string",
"title": "Status"
},
"data_kind": {
"enum": [
"synthetic",
"resolved"
],
"type": "string",
"title": "Data Kind"
},
"account_id": {
"type": "string",
"title": "Account Id"
},
"key_prefix": {
"type": "string",
"title": "Key Prefix"
},
"paid_until": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Paid Until",
"default": null
},
"next_action": {
"type": "string",
"title": "Next Action"
},
"trial_ends_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Trial Ends At",
"default": null
},
"evaluation_mode": {
"type": "boolean",
"title": "Evaluation Mode"
},
"resolution_state": {
"type": "string",
"title": "Resolution State"
},
"evaluation_expires_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Evaluation Expires At",
"default": null
},
"evaluation_install_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Evaluation Install Url",
"default": null
}
},
"additionalProperties": true
},
"annotations": {
"title": "Check account identity",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Whether this account can use pixels and whether a tag is installed. setup_complete is true once at least one pixel's tag has been seen on its site. good_standing is the account, not the tag.
No parameters.
{
"name": "setup_status",
"title": "Read installation progress",
"description": "Whether this account can use pixels and whether a tag is installed.\n\n setup_complete is true once at least one pixel's tag has been seen on\n its site. good_standing is the account, not the tag.\n ",
"inputSchema": {
"type": "object",
"title": "setup_statusArguments",
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"title": "Setup",
"required": [
"good_standing",
"pixel_count",
"installed_count",
"setup_complete"
],
"properties": {
"pixel_count": {
"type": "integer",
"title": "Pixel Count"
},
"good_standing": {
"type": "boolean",
"title": "Good Standing"
},
"setup_complete": {
"type": "boolean",
"title": "Setup Complete"
},
"installed_count": {
"type": "integer",
"title": "Installed Count"
}
},
"additionalProperties": true
},
"annotations": {
"title": "Read installation progress",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Pixels on this account. Each item has pixel_id, domain, and install_status.
No parameters.
{
"name": "list_pixels",
"title": "List my pixels",
"description": "Pixels on this account. Each item has pixel_id, domain, and install_status.",
"inputSchema": {
"type": "object",
"title": "list_pixelsArguments",
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"Pixel": {
"type": "object",
"title": "Pixel",
"required": [
"pixel_id",
"domain",
"install_status",
"evaluation_mode",
"data_kind"
],
"properties": {
"domain": {
"type": "string",
"title": "Domain"
},
"snippet": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Snippet",
"default": null
},
"pixel_id": {
"type": "string",
"title": "Pixel Id"
},
"data_kind": {
"enum": [
"synthetic",
"resolved"
],
"type": "string",
"title": "Data Kind"
},
"checked_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Checked At",
"default": null
},
"check_error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Check Error",
"default": null
},
"install_status": {
"enum": [
"not_checked",
"installed",
"not_installed",
"unreachable"
],
"type": "string",
"title": "Install Status"
},
"consent_enabled": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Consent Enabled",
"default": null
},
"evaluation_mode": {
"type": "boolean",
"title": "Evaluation Mode"
}
},
"additionalProperties": true
}
},
"title": "PixelList",
"required": [
"pixels"
],
"properties": {
"pixels": {
"type": "array",
"items": {
"$ref": "#/$defs/Pixel"
},
"title": "Pixels"
}
},
"additionalProperties": true
},
"annotations": {
"title": "List my pixels",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Create a pixel for a domain. Does not create an API key. The account must already be active. Next: call configure_consent(pixel_id, controller_name, purposes) and install the snippet it returns. Do not install a snippet before consent is configured. install_status starts as not_checked until check_install runs.
| Parameter | Type | Description |
|---|---|---|
| domain * | string | Public hostname of the site, without scheme, port, path or IP address. Example: shop.example.com |
{
"name": "create_pixel",
"title": "Create site pixel",
"description": "Create a pixel for a domain.\n\n Does not create an API key. The account must already be active.\n Next: call configure_consent(pixel_id, controller_name, purposes) and install the snippet it returns.\n Do not install a snippet before consent is configured. install_status starts as not_checked until check_install runs.\n ",
"inputSchema": {
"type": "object",
"title": "create_pixelArguments",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"title": "Domain",
"pattern": "^[A-Za-z0-9](?:[A-Za-z0-9.-]*[A-Za-z0-9])?$",
"maxLength": 253,
"minLength": 3,
"description": "Public hostname of the site, without scheme, port, path or IP address. Example: shop.example.com"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"title": "Pixel",
"required": [
"pixel_id",
"domain",
"install_status",
"evaluation_mode",
"data_kind"
],
"properties": {
"domain": {
"type": "string",
"title": "Domain"
},
"snippet": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Snippet",
"default": null
},
"pixel_id": {
"type": "string",
"title": "Pixel Id"
},
"data_kind": {
"enum": [
"synthetic",
"resolved"
],
"type": "string",
"title": "Data Kind"
},
"checked_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Checked At",
"default": null
},
"check_error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Check Error",
"default": null
},
"install_status": {
"enum": [
"not_checked",
"installed",
"not_installed",
"unreachable"
],
"type": "string",
"title": "Install Status"
},
"consent_enabled": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Consent Enabled",
"default": null
},
"evaluation_mode": {
"type": "boolean",
"title": "Evaluation Mode"
}
},
"additionalProperties": true
},
"annotations": {
"title": "Create site pixel",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}One pixel, including the HTML snippet to paste on its site.
| Parameter | Type | Description |
|---|---|---|
| pixel_id * | string | pixel_id returned by create_pixel or list_pixels, never an account_id. Example: px_7a1b2c3d4e5f6a7b |
{
"name": "get_pixel",
"title": "Read pixel and install tag",
"description": "One pixel, including the HTML snippet to paste on its site.",
"inputSchema": {
"type": "object",
"title": "get_pixelArguments",
"required": [
"pixel_id"
],
"properties": {
"pixel_id": {
"type": "string",
"title": "Pixel Id",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 80,
"minLength": 1,
"description": "pixel_id returned by create_pixel or list_pixels, never an account_id. Example: px_7a1b2c3d4e5f6a7b"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"title": "Pixel",
"required": [
"pixel_id",
"domain",
"install_status",
"evaluation_mode",
"data_kind"
],
"properties": {
"domain": {
"type": "string",
"title": "Domain"
},
"snippet": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Snippet",
"default": null
},
"pixel_id": {
"type": "string",
"title": "Pixel Id"
},
"data_kind": {
"enum": [
"synthetic",
"resolved"
],
"type": "string",
"title": "Data Kind"
},
"checked_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Checked At",
"default": null
},
"check_error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Check Error",
"default": null
},
"install_status": {
"enum": [
"not_checked",
"installed",
"not_installed",
"unreachable"
],
"type": "string",
"title": "Install Status"
},
"consent_enabled": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Consent Enabled",
"default": null
},
"evaluation_mode": {
"type": "boolean",
"title": "Evaluation Mode"
}
},
"additionalProperties": true
},
"annotations": {
"title": "Read pixel and install tag",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Fetch the pixel's homepage and store whether the tag is there. install_status becomes installed or not_installed. check_error says why a check could not decide. Evaluator accounts fetch only the fixed https://staging.allsourcedata.io/evaluation-test/ page and reject redirects.
| Parameter | Type | Description |
|---|---|---|
| pixel_id * | string | pixel_id of the pixel whose homepage to check. Example: px_7a1b2c3d4e5f6a7b |
{
"name": "check_install",
"title": "Check and save installation",
"description": "Fetch the pixel's homepage and store whether the tag is there.\n\n install_status becomes installed or not_installed. check_error says\n why a check could not decide. Evaluator accounts fetch only the fixed\n https://staging.allsourcedata.io/evaluation-test/ page and reject redirects.\n ",
"inputSchema": {
"type": "object",
"title": "check_installArguments",
"required": [
"pixel_id"
],
"properties": {
"pixel_id": {
"type": "string",
"title": "Pixel Id",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 80,
"minLength": 1,
"description": "pixel_id of the pixel whose homepage to check. Example: px_7a1b2c3d4e5f6a7b"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"title": "Pixel",
"required": [
"pixel_id",
"domain",
"install_status",
"evaluation_mode",
"data_kind"
],
"properties": {
"domain": {
"type": "string",
"title": "Domain"
},
"snippet": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Snippet",
"default": null
},
"pixel_id": {
"type": "string",
"title": "Pixel Id"
},
"data_kind": {
"enum": [
"synthetic",
"resolved"
],
"type": "string",
"title": "Data Kind"
},
"checked_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Checked At",
"default": null
},
"check_error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Check Error",
"default": null
},
"install_status": {
"enum": [
"not_checked",
"installed",
"not_installed",
"unreachable"
],
"type": "string",
"title": "Install Status"
},
"consent_enabled": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Consent Enabled",
"default": null
},
"evaluation_mode": {
"type": "boolean",
"title": "Evaluation Mode"
}
},
"additionalProperties": true
},
"annotations": {
"title": "Check and save installation",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Turn on and set up the consent bar for a pixel. Changing any setting makes a new policy version, and returning visitors are asked again. Returns the policy link and the script tag to put on the site.
| Parameter | Type | Description |
|---|---|---|
| pixel_id * | string | pixel_id of the pixel to configure. Example: px_7a1b2c3d4e5f6a7b |
| purposes * | array | What the consent bar asks the visitor to allow. One or more of: analytics, resolution, newsletter, email_sharing, phone_sharing, partner_email, partner_calls, partner_sms. Include resolution, or no visitor is ever identified. Example: ["resolution", "analytics"] |
| data_sharing | any | Optional. true if the site owner shares consented contact data with other parties, false if not. Shown in the hosted notice. Example: false |
| controller_name * | string | Name of the business or person that owns the site. It is shown in the consent bar as the party asking the visitor for permission. 1 to 200 characters. Example: Example Shop LLC |
| controller_type | any | Optional. One of company, person or organization. Describes the site owner in the hosted notice. Example: company |
| site_policy_url | any | Optional. HTTPS address of the site's own privacy policy. The bar links to it, and the hosted notice becomes a short add-on about identification. Leave empty to use the hosted notice on its own. Example: https://shop.example.com/privacy |
| contact_channels | any | Optional. How the site owner may contact a visitor who consents. Any of: email, phone, sms, agentic. Example: ["email"] |
| disclosed_parties | any | Optional. Names of the other parties the site owner wants the hosted notice to list, one name per item. Example: ["Example CRM Inc."] |
| controller_contact | any | Optional. Email address or web address where visitors can reach the site owner about their data. Shown in the hosted notice. Example: privacy@example.com |
| controller_jurisdiction | any | Optional. Where the site owner is based, as plain text, such as a country or US state. Shown in the hosted notice. Example: Florida, USA |
{
"name": "configure_consent",
"title": "Configure consent and policy",
"description": "Turn on and set up the consent bar for a pixel.\n\n Changing any setting makes a new policy version, and returning visitors are asked again.\n Returns the policy link and the script tag to put on the site.\n ",
"inputSchema": {
"type": "object",
"title": "configure_consentArguments",
"required": [
"pixel_id",
"controller_name",
"purposes"
],
"properties": {
"pixel_id": {
"type": "string",
"title": "Pixel Id",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 80,
"minLength": 1,
"description": "pixel_id of the pixel to configure. Example: px_7a1b2c3d4e5f6a7b"
},
"purposes": {
"type": "array",
"items": {
"enum": [
"analytics",
"resolution",
"newsletter",
"email_sharing",
"phone_sharing",
"partner_email",
"partner_calls",
"partner_sms"
],
"type": "string"
},
"title": "Purposes",
"maxItems": 8,
"minItems": 1,
"description": "What the consent bar asks the visitor to allow. One or more of: analytics, resolution, newsletter, email_sharing, phone_sharing, partner_email, partner_calls, partner_sms. Include resolution, or no visitor is ever identified. Example: [\"resolution\", \"analytics\"]"
},
"data_sharing": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Data Sharing",
"default": null,
"description": "Optional. true if the site owner shares consented contact data with other parties, false if not. Shown in the hosted notice. Example: false"
},
"controller_name": {
"type": "string",
"title": "Controller Name",
"maxLength": 200,
"minLength": 1,
"description": "Name of the business or person that owns the site. It is shown in the consent bar as the party asking the visitor for permission. 1 to 200 characters. Example: Example Shop LLC"
},
"controller_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Controller Type",
"default": null,
"description": "Optional. One of company, person or organization. Describes the site owner in the hosted notice. Example: company"
},
"site_policy_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Site Policy Url",
"default": null,
"description": "Optional. HTTPS address of the site's own privacy policy. The bar links to it, and the hosted notice becomes a short add-on about identification. Leave empty to use the hosted notice on its own. Example: https://shop.example.com/privacy"
},
"contact_channels": {
"anyOf": [
{
"type": "array",
"items": {
"enum": [
"email",
"phone",
"sms",
"agentic"
],
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Contact Channels",
"default": null,
"description": "Optional. How the site owner may contact a visitor who consents. Any of: email, phone, sms, agentic. Example: [\"email\"]"
},
"disclosed_parties": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Disclosed Parties",
"default": null,
"description": "Optional. Names of the other parties the site owner wants the hosted notice to list, one name per item. Example: [\"Example CRM Inc.\"]"
},
"controller_contact": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Controller Contact",
"default": null,
"description": "Optional. Email address or web address where visitors can reach the site owner about their data. Shown in the hosted notice. Example: privacy@example.com"
},
"controller_jurisdiction": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Controller Jurisdiction",
"default": null,
"description": "Optional. Where the site owner is based, as plain text, such as a country or US state. Shown in the hosted notice. Example: Florida, USA"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"title": "Consent",
"required": [
"pixel_id",
"consent_enabled",
"policy_version",
"policy_hash",
"policy_url",
"snippet",
"purposes"
],
"properties": {
"snippet": {
"type": "string",
"title": "Snippet"
},
"pixel_id": {
"type": "string",
"title": "Pixel Id"
},
"purposes": {
"type": "array",
"items": {
"enum": [
"analytics",
"resolution",
"newsletter",
"email_sharing",
"phone_sharing",
"partner_email",
"partner_calls",
"partner_sms"
],
"type": "string"
},
"title": "Purposes"
},
"policy_url": {
"type": "string",
"title": "Policy Url"
},
"policy_hash": {
"type": "string",
"title": "Policy Hash"
},
"policy_version": {
"type": "integer",
"title": "Policy Version"
},
"consent_enabled": {
"type": "boolean",
"title": "Consent Enabled"
}
},
"additionalProperties": true
},
"annotations": {
"title": "Configure consent and policy",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}
}Hosted privacy and data-use policy HTML for a pixel. A pixel with consent turned off has no policy yet.
| Parameter | Type | Description |
|---|---|---|
| pixel_id * | string | pixel_id whose hosted notice to read. Example: px_7a1b2c3d4e5f6a7b |
{
"name": "get_policy",
"title": "Read hosted privacy notice",
"description": "Hosted privacy and data-use policy HTML for a pixel.\n\n A pixel with consent turned off has no policy yet.\n ",
"inputSchema": {
"type": "object",
"title": "get_policyArguments",
"required": [
"pixel_id"
],
"properties": {
"pixel_id": {
"type": "string",
"title": "Pixel Id",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 80,
"minLength": 1,
"description": "pixel_id whose hosted notice to read. Example: px_7a1b2c3d4e5f6a7b"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"title": "Policy",
"required": [
"pixel_id",
"policy_html"
],
"properties": {
"pixel_id": {
"type": "string",
"title": "Pixel Id"
},
"policy_html": {
"type": "string",
"title": "Policy Html"
}
},
"additionalProperties": true
},
"annotations": {
"title": "Read hosted privacy notice",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Contacts for one pixel. Pass on as a UTC day, or after as the high_water from the previous pull. Use high_water as the next cursor. New contacts can arrive between reads. This does not identify new visitors. Evaluation returns labeled synthetic examples only after current resolution consent is saved; withdrawal hides them.
| Parameter | Type | Description |
|---|---|---|
| on | any | UTC calendar date in YYYY-MM-DD form. Returns contacts stored on that day. Use exactly one of on or after. Example: 2026-10-12 |
| after | any | Cursor for incremental reads: the high_water value from your previous pull, or 0 to start at the first stored contact. Use exactly one of on or after. Example: 0 |
| pixel_id * | string | pixel_id whose contacts to read. Example: px_7a1b2c3d4e5f6a7b |
{
"name": "get_contacts",
"title": "Read contacts",
"description": "Contacts for one pixel.\n\n Pass on as a UTC day, or after as the high_water from the previous pull. Use high_water as the next cursor.\n New contacts can arrive between reads. This does not identify new visitors.\n Evaluation returns labeled synthetic examples only after current resolution consent is saved; withdrawal hides them.\n ",
"inputSchema": {
"type": "object",
"oneOf": [
{
"required": [
"on"
],
"properties": {
"on": {
"type": "string"
},
"after": {
"type": "null"
}
}
},
{
"required": [
"after"
],
"properties": {
"on": {
"type": "null"
},
"after": {
"type": "integer"
}
}
}
],
"title": "get_contactsArguments",
"required": [
"pixel_id"
],
"properties": {
"on": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "UTC calendar date YYYY-MM-DD; choose on OR after, exactly one"
},
{
"type": "null"
}
],
"title": "On",
"default": null,
"description": "UTC calendar date in YYYY-MM-DD form. Returns contacts stored on that day. Use exactly one of on or after. Example: 2026-10-12"
},
"after": {
"anyOf": [
{
"type": "integer",
"maximum": 9223372036854776000,
"minimum": 0,
"description": "Stored contact ID high_water from previous pull; 0 starts at first contact. Choose after OR on, exactly one"
},
{
"type": "null"
}
],
"title": "After",
"default": null,
"description": "Cursor for incremental reads: the high_water value from your previous pull, or 0 to start at the first stored contact. Use exactly one of on or after. Example: 0"
},
"pixel_id": {
"type": "string",
"title": "Pixel Id",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 80,
"minLength": 1,
"description": "pixel_id whose contacts to read. Example: px_7a1b2c3d4e5f6a7b"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"Contact": {
"type": "object",
"title": "Contact",
"required": [
"id",
"hem",
"resolved_at",
"contact"
],
"properties": {
"id": {
"type": "integer",
"title": "Id"
},
"hem": {
"type": "string",
"title": "Hem"
},
"contact": {
"type": "object",
"title": "Contact",
"additionalProperties": true
},
"synthetic": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Synthetic",
"default": null
},
"resolved_at": {
"type": "string",
"title": "Resolved At"
}
},
"additionalProperties": true
}
},
"title": "Contacts",
"required": [
"pixel_id",
"contacts"
],
"properties": {
"on": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "On",
"default": null
},
"after": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "After",
"default": null
},
"contacts": {
"type": "array",
"items": {
"$ref": "#/$defs/Contact"
},
"title": "Contacts"
},
"pixel_id": {
"type": "string",
"title": "Pixel Id"
},
"data_kind": {
"anyOf": [
{
"enum": [
"synthetic",
"resolved"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Data Kind",
"default": null
},
"high_water": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "High Water",
"default": null
},
"evaluation_mode": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Evaluation Mode",
"default": null
}
},
"additionalProperties": true
},
"annotations": {
"title": "Read contacts",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}AgentPixel: a consent-first website pixel. The snippet from configure_consent shows a Cookie Permissions bar. Visitors click Accept to be identified. Each acceptance is stored with the policy hash and origin. Install only the configure_consent snippet on the site. Accounts read contacts. No key yet: 1. Call try_sample to see labeled sample output. It needs no account and no key. 2. Ask the person for their email address, then call signup_free(email, display_name). It starts Free with 200 new contacts per month, no card, and emails a 6-digit code. Keep account_id and signup_token from the result. 3. Ask the person for the 6-digit code in the AgentPixel email. Call confirm_signup(account_id, code, signup_token). The first confirmation returns the API key. If the person clicked the email link instead, call confirm_signup(account_id, signup_token) every 5 seconds, for up to 10 minutes, until email_verified is true. Then call create_api_key(account_id, signup_token). If the code expired or is lost, call resend_code(email). 4. Store the key securely. Reconnect with Authorization: Bearer <key> or X-API-Key: <key>. The key belongs to the connection. Never pass it as a tool argument. With a key: 1. create_pixel(domain) returns a pixel_id for that site. 2. configure_consent(pixel_id, controller_name, purposes) turns on the consent bar and returns the snippet to install. Include "resolution" in purposes. 3. Put the snippet from configure_consent on the site. Do not install a snippet before consent is configured. Then call check_install(pixel_id). 4. get_contacts(pixel_id, on=YYYY-MM-DD) or get_contacts(pixel_id, after=high_water) reads contacts. whoami, setup_status, list_pixels, get_pixel and get_policy read account and pixel state. Pricing: Free 200 contacts/month. Starter $49 for 1,000, Growth $199 for 5,000, Unlimited $499/month. Each includes one website and subdomains. Paid extras: website $19/month, 500-contact pack $39 current period only. Read GET /v1/plans and /v1/billing. No automatic overage charges. Errors are tool errors with an HTTP code: 400 fix the arguments; 401 use a valid private connection key; 403 follow the account or evaluator next action; 404 use a pixel on your own account; 409 resolve the conflicting registration; 429 wait before retrying; 502 or 503 retry later with bounded backoff. Do not blindly retry signup or key issuance, because they can send email or issue another key. Evaluator connections are isolated: synthetic fixtures only, with no email, key issuance, payment or live identification. Use staging.allsourcedata.io/evaluation-test/, configure consent, and read synthetic examples after accepted resolution consent. Evaluation output is labeled. It is not proof of live identification.
Names, descriptions and schemas were written by the server and are shown as data.