AgentPixel
Measured conclusion: Alive, not deep-tested. L2 outcome: not_attempted.
Most visitors never fill out a form. Turn the ones who click Accept into contacts your agent reads.
| Author | io.agentpixel |
|---|---|
| Access | remote |
| Publisher key required | No |
| Measured state | Alive, not deep-tested |
| L1 liveness | alive |
| L1 latency | 2544 ms |
| Last measured | 2026-10-26 |
Add to your agent
Copy this into your MCP client config:
{
"mcpServers": {
"AgentPixel": {
"url": "https://agentpixel.io/mcp",
"transport": "streamable-http"
}
}
}
Measured tools (14)
try_sampleread-onlyLabeled 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.
Hints: read-only yes · destructive no · idempotent yes · open-world no
signup_freeStart a 30-day trial, no card. After that, $1 per account per month for 3 pixels and 500 new contacts per UTC calendar 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.
Parameters:
email(required) — 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: [email protected]display_name(required) — string — Name shown on the account, such as the person's name or the business name. 1 to 200 characters. Example: Pat Leecode— Optional trial code from a directory or listing, such as SMITHERY60. An unknown code never blocks signup. Example: GLAMA60
Hints: read-only no · destructive no · idempotent no · open-world yes
confirm_signupConfirm 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).
Parameters:
code— The 6-digit code from the AgentPixel email. Ask the person to read it to you. Example: 482913account_id— 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-0a1b2c3d4e5fsignup_token— 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— Older method: the token value from the confirmation link URL (?token=...). Prefer account_id and code.
Hints: read-only no · destructive no · idempotent yes · open-world no
resend_codeSend 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.
Parameters:
email(required) — string — Email address used at signup. A new 6-digit code and link are sent there. Example: [email protected]
Hints: read-only no · destructive no · idempotent no · open-world yes
create_api_keyIssue 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.
Parameters:
account_id(required) — string — account_id returned by signup_free. Example: 3f1c2b9e-1d2a-4c5b-9e8f-0a1b2c3d4e5fsignup_token(required) — string — signup_token returned by signup_free. It lasts 24 hours.
Hints: read-only no · destructive no · idempotent no · open-world no
whoamiread-onlyWhich account this connection's API key belongs to. status is the account state after email confirmation. plan is "free" (the trial plan id) during the 30-day trial, paid after the subscription, or unlimited for internal accounts. trial_ends_at is when the trial ends. key_prefix is the start of the key, not the key.
Hints: read-only yes · destructive no · idempotent yes · open-world no
setup_statusread-onlyWhether 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.
Hints: read-only yes · destructive no · idempotent yes · open-world no
list_pixelsread-onlyPixels on this account. Each item has pixel_id, domain, and install_status.
Hints: read-only yes · destructive no · idempotent yes · open-world no
create_pixelCreate 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.
Parameters:
domain(required) — string — Public hostname of the site, without scheme, port, path or IP address. Example: shop.example.com
Hints: read-only no · destructive no · idempotent no · open-world yes
get_pixelread-onlyOne pixel, including the HTML snippet to paste on its site.
Parameters:
pixel_id(required) — string — pixel_id returned by create_pixel or list_pixels, never an account_id. Example: px_7a1b2c3d4e5f6a7b
Hints: read-only yes · destructive no · idempotent yes · open-world no
check_installFetch 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.
Parameters:
pixel_id(required) — string — pixel_id of the pixel whose homepage to check. Example: px_7a1b2c3d4e5f6a7b
Hints: read-only no · destructive no · idempotent no · open-world yes
configure_consentdestructiveTurn 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.
Parameters:
pixel_id(required) — string — pixel_id of the pixel to configure. Example: px_7a1b2c3d4e5f6a7bcontroller_name(required) — 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 LLCpurposes(required) — 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— Optional. true if the site owner shares consented contact data with other parties, false if not. Shown in the hosted notice. Example: falsecontroller_type— Optional. One of company, person or organization. Describes the site owner in the hosted notice. Example: companysite_policy_url— 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/privacycontact_channels— Optional. How the site owner may contact a visitor who consents. Any of: email, phone, sms, agentic. Example: ["email"]disclosed_parties— 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— Optional. Email address or web address where visitors can reach the site owner about their data. Shown in the hosted notice. Example: [email protected]controller_jurisdiction— 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
Hints: read-only no · destructive yes · idempotent no · open-world no
get_policyread-onlyHosted privacy and data-use policy HTML for a pixel. A pixel with consent turned off has no policy yet.
Parameters:
pixel_id(required) — string — pixel_id whose hosted notice to read. Example: px_7a1b2c3d4e5f6a7b
Hints: read-only yes · destructive no · idempotent yes · open-world no
get_contactsread-onlyContacts 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.
Parameters:
pixel_id(required) — string — pixel_id whose contacts to read. Example: px_7a1b2c3d4e5f6a7bon— UTC calendar date in YYYY-MM-DD form. Returns contacts stored on that day. Use exactly one of on or after. Example: 2026-10-12after— 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
Hints: read-only yes · destructive no · idempotent yes · open-world no
Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.