Integration

Cometly integration

Cometly is a marketing attribution platform. Send conversion events (purchases, leads, sign-ups, custom events) to attribute them to ad campaigns, list and read events with their attribution, correct or delete an event, and manage contacts and companies: create, look up by id or email, update, attach a contact to a company, and permanently scrub a contact's personal data. The asynchronous file exports and the analytics MCP server are not included. Authentication: an API key generated on the Cometly API integration page, sent as a Bearer token in the Authorization header.

Connect Cometly How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Cometly.Built from the 17 Cometly tools below, on the connection you add once.

What you can do with Cometly

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Contact, 5 operations

create_contactCreate contactPOSTCreate a new contact with arrays of emails, phones, names, and locations.
get_contactGet contactGETRetrieve details of a specific contact by its ID. Automatically resolves merged profiles.
get_contact_by_emailGet contact by emailGETGets one contact by email address (exact, case-insensitive, across primary, alternate and merged-profile addresses). Fails with 404 when no contact matches and 409 when several do.
list_contactsList contactsGETLists contacts (primary data only) created between start_date and end_date, or looks them up by email (then the dates are optional). Pass next_cursor as cursor for the next page.
update_contactUpdate contactPUTUpdate an existing contact's emails, phones, names, locations, or custom fields using sparse PUT semantics.

Event, 5 operations

create_eventCreate eventPOSTSends a conversion event (a standard event such as purchase or lead_generated, or custom_event_1 to custom_event_50). Identify the person with email, comet_token, or fingerprint plus ip. Queued: returns no event id.
delete_eventDelete eventDELETEDeletes an event by its id (from list_events or get_event). Idempotent: deleting an event that does not exist still answers success.
get_eventGet eventGETRetrieve details of a specific event by its ID.
list_eventsList eventsGETLists events between start_date and end_date (both required, YYYY-MM-DD HH:MM:SS in the Space's timezone), optionally with ad attribution. Pass next_cursor as cursor for the next page.
update_eventUpdate eventPUTChanges the amount of an already-ingested event (the only updatable field). Pass the event id from list_events or get_event; null clears the amount.

Company, 3 operations

get_companyGet companyGETRetrieve details of a specific company by its ID.
list_companiesList companiesGETRetrieve a paginated list of companies with optional date filtering.
update_companyUpdate companyPUTUpdate an existing company's domain, external ID, or name using sparse PUT semantics. Any field you include replaces the existing value; any field you omit is left untouched.

Contact company, 2 operations

attach_contact_companyAttach contact companyPUTAttach a contact to a company. A contact belongs to at most one company per Space, so this moves it off any company it currently belongs to.
detach_contact_companyDetach contact companyDELETEDetach a contact from its company, leaving it with no company.

Contact pii, 2 operations

delete_contact_piiDelete contact piiDELETEPermanently scrub a contact's personally identifiable information by contact ID. Preserves the contact record, its events, and merge history.
delete_contact_pii_by_emailDelete contact pii by emailDELETEPermanently scrub a contact's personally identifiable information by email address. Preserves the contact record, its events, and merge history.

Use Cometly from Claude Code, Cursor or Codex

Connect Cometly in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Cometly operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Cometly

Create your workspace
Sign up free. Nothing to install.
Connect Cometly once
Add your Cometly connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.