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.

Install one skill and your agent can manage contacts, fire events, send email, build segments from a plain description, send and measure broadcasts, trigger workflows, and wire up webhooks in your space.

Install

The recommended install works with any skills-compatible agent. It reads https://maxclicks.ai/.well-known/skills/index.json and writes the skills into your agent's skills directory.

npx skills add https://maxclicks.ai

# update later
npx skills update -y

The Claude Code plugin auto-updates. Cursor uses the same marketplace or the npx command. Codex and Gemini CLI use the npx command; Gemini CLI can also install the repo as an extension via gemini-extension.json.

API compatibility

Skills are instructions, not an API implementation. Some source instructions and tools describe the earlier client contract. Give your agent the current REST reference as the source of truth for event receipts/readiness, record deletion, workflow history, and supported idempotency headers. An instruction to search records does not add a public record-search endpoint.

Prerequisites

A maxclicks API key, which ties the agent to one space. Create one in the app under a space's Settings, in Developers, on the API keys tab, then set MAXCLICKS_API_KEY or run maxclicks config set-key <key>. Authentication covers how a key is scoped and what each role can do.
The maxclicks CLI for terminal operations: npm install -g maxclicks-cli. Not published to npm yet, so this does not resolve today.
The SDKs for application code (Node, Python, Go, PHP, Ruby, Java, Rust, Elixir). Registry releases are still pending, so check that page for where each one stands.
The MCP server for MCP hosts, at https://mcp.maxclicks.ai/mcp.

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`	Nothing over the API. CSV import is an app feature, and the API has no import endpoints.
`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 skills have not been regenerated since the API surface narrowed. Several still describe endpoints that now return 404, among them schema and attribute writes, template and broadcast authoring, domain, sender and topic writes, and everything under imports and API keys. Where a skill and this documentation disagree, this documentation is current.

Skills reach for the CLI first, because it covers the whole API. The SDKs cover the core record, event, email, and template calls. For what each one supports today, read the maxclicks skill's references/sdks.md.

The agent

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

Agent Skills

Install

The recommended install works with any skills-compatible agent. It reads https://maxclicks.ai/.well-known/skills/index.json and writes the skills into your agent's skills directory.

npx skills add https://maxclicks.ai

# update later
npx skills update -y

API compatibility

Prerequisites

A maxclicks API key, which ties the agent to one space. Create one in the app under a space's Settings, in Developers, on the API keys tab, then set MAXCLICKS_API_KEY or run maxclicks config set-key <key>. Authentication covers how a key is scoped and what each role can do.

The maxclicks CLI for terminal operations: npm install -g maxclicks-cli. Not published to npm yet, so this does not resolve today.

The SDKs for application code (Node, Python, Go, PHP, Ruby, Java, Rust, Elixir). Registry releases are still pending, so check that page for where each one stands.

The MCP server for MCP hosts, at https://mcp.maxclicks.ai/mcp.

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`	Nothing over the API. CSV import is an app feature, and the API has no import endpoints.
`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.