Agent Skills

Give your coding agent the maxclicks data model and API conventions it needs to build an integration. Agent skills provide task-specific instructions; API credentials and tools provide access to your workspace.

For a first integration, follow agent onboarding. Install the skills below to give your agent task-specific guidance alongside the API reference.

Install

Install the skills into your coding agent:

npx skills add https://maxclicks.ai

The package supports skills-compatible coding agents. Follow your host’s skill-loading instructions, and update installed skills with npx skills update -y. For manual installation, copy the relevant skills/<name>/ directory from the maxclicks-ai repository into your agent’s supported skills directory.

API compatibility

Skills work with the Public API, the CLI, SDKs, and MCP server. Give your agent the API reference for request fields, response states, permissions, and idempotency behavior. Skills provide guidance; your configured client and API key provide workspace access.

Prerequisites

A workspace API key, stored in the agent's environment as MAXCLICKS_API_KEY.
The API reference for request and response details.
A configured CLI, SDK, MCP server, or HTTP client.

The skills

Start with the maxclicks skill. It is the entry point, it loads on any maxclicks task, and every other skill builds on it. Add the skill for whichever area you are working in.

The skills inherit the line the API draws: you build things in the app, and an agent triggers, reads, and measures them. Schemas, attributes, templates, sending domains, senders, topics, and API keys are all created and edited in the app, and so is a broadcast and the email inside it, though an agent can still rename a broadcast, change its audience or its schedule, and send it.

Skill	Covers
`maxclicks`	Entry point: auth, the schema-based data model, the CLI/SDK/API map, and the top gotchas.
`maxclicks-contacts`	Create, update, list, or delete contacts and objects (records), and read a contact audit trail.
`maxclicks-events`	Fire and list events to trigger workflows and webhooks.
`maxclicks-email`	Send a stored template to a contact, and manage email suppressions.
`maxclicks-templates`	Before a send, read a template and what it needs: the information it expects (`expectedDataRepresentation`), who receives it, and which sender it uses. Writing the template itself happens in the app.
`maxclicks-adaptyle`	Write a template's subject and body in Adaptyle over Liquid, with MJML or HTML raw bodies, in the app's editor.
`maxclicks-segments`	Build segments: contact filters that AI writes from a plain description.
`maxclicks-broadcasts`	Schedule and send a broadcast drafted in the app, then read its runs and metrics.
`maxclicks-deliverability`	Read sending domains and saved senders, and check whether a domain is verified. Registering and verifying a domain happens in the app, because it claims the name and sets up the sending resources behind it.
`maxclicks-topics`	Read communication topics to pick the `communicationTopicId` for a consent-scoped marketing send. Topics are managed in the app.
`maxclicks-imports`	Bulk CSV import of contacts and objects in the app.
`maxclicks-workflows`	Trigger a workflow through its incoming-webhook step, and observe runs.
`maxclicks-webhooks`	Create and manage outgoing webhooks, and verify inbound signatures.

The agent

Agent	Use it for
`maxclicks-integration-engineer`	Building or debugging a full maxclicks integration end to end.

Agent Skills

For a first integration, follow agent onboarding. Install the skills below to give your agent task-specific guidance alongside the API reference.

Install

Install the skills into your coding agent:

npx skills add https://maxclicks.ai

The skills

Start with the maxclicks skill. It is the entry point, it loads on any maxclicks task, and every other skill builds on it. Add the skill for whichever area you are working in.

Skill	Covers
`maxclicks`	Entry point: auth, the schema-based data model, the CLI/SDK/API map, and the top gotchas.
`maxclicks-contacts`	Create, update, list, or delete contacts and objects (records), and read a contact audit trail.
`maxclicks-events`	Fire and list events to trigger workflows and webhooks.
`maxclicks-email`	Send a stored template to a contact, and manage email suppressions.
`maxclicks-templates`	Before a send, read a template and what it needs: the information it expects (`expectedDataRepresentation`), who receives it, and which sender it uses. Writing the template itself happens in the app.
`maxclicks-adaptyle`	Write a template's subject and body in Adaptyle over Liquid, with MJML or HTML raw bodies, in the app's editor.
`maxclicks-segments`	Build segments: contact filters that AI writes from a plain description.
`maxclicks-broadcasts`	Schedule and send a broadcast drafted in the app, then read its runs and metrics.
`maxclicks-deliverability`	Read sending domains and saved senders, and check whether a domain is verified. Registering and verifying a domain happens in the app, because it claims the name and sets up the sending resources behind it.
`maxclicks-topics`	Read communication topics to pick the `communicationTopicId` for a consent-scoped marketing send. Topics are managed in the app.
`maxclicks-imports`	Bulk CSV import of contacts and objects in the app.
`maxclicks-workflows`	Trigger a workflow through its incoming-webhook step, and observe runs.
`maxclicks-webhooks`	Create and manage outgoing webhooks, and verify inbound signatures.

Agent

Use it for

maxclicks-integration-engineer

Building or debugging a full maxclicks integration end to end.