Use maxclicks in Cursor

Use the agent onboarding brief to connect your workspace, then add MCP tools or agent skills using the setup below. For direct HTTP requests, follow the HTTP quickstart.

Give Cursor the workspace context it needs to build your maxclicks integration. Begin with reads before changing records or sending email.

Option	What the agent gets	Add it in
MCP server	Tools that map to the Public API v1, callable directly.	`.cursor/mcp.json`
maxclicks skill	13 skills that teach the data model, the `maxclicks` CLI, and the SDKs.	Agent skills directory

Get an API key

Create a key at app.maxclicks.ai/space/-/settings/developers. A key is scoped to one space. Some operations need an admin key (suppressions). Keys are created in the app, not over the API. Never commit the key.

Add the MCP server

Cursor reads MCP servers from .cursor/mcp.json in a project, or ~/.cursor/mcp.json for every project. Add a maxclicks entry, then reload the window.

Remote (hosted)

Connect to https://mcp.maxclicks.ai/mcp. A client that supports MCP sign-in opens maxclicks so you can choose the workspace and approve what it may do; otherwise configure it to send your API key in its Authorization: Bearer header. Verify whoami before any write.

{
  "mcpServers": {
    "maxclicks": { "url": "https://mcp.maxclicks.ai/mcp" }
  }
}

After you reload, Cursor asks you to sign in to the server and opens the maxclicks consent page in your browser.

Local (stdio)

Requires Node.js 18 or newer. Configure the client to run the npm package with your API key:

{
  "mcpServers": {
    "maxclicks": {
      "command": "npx",
      "args": ["-y", "maxclicks-mcp"],
      "env": { "MAXCLICKS_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Keep this configuration out of version control. Confirm the host can start the local process and successfully call whoami.

Tools

The tools cover records, events, segments, webhooks, suppressions, workflow triggers and runs, template sends, and broadcast sends and metrics. They can also read (but not change) your schemas, attributes, domains, senders, and topics.

Create schemas, attributes, templates, broadcasts and sending settings in the maxclicks app, then use the supported tools to read definitions and act on prepared work. Broadcast operations can update supported fields such as the name, audience or schedule and request a send. The API reference defines request fields, response states, and permissions. Review the saved campaign and its readiness before requesting execution.

Call list_schemas and list_attributes to learn how your data is shaped, then write records with upsert_record. Confirm the connection with whoami: it returns the key, who owns it, and which space it belongs to.

Every call belongs to a schema, and records are flat. Put base fields and your own attribute keys at the top level of a record, not nested under a data key. If you write a key the schema does not define, it is dropped and returned as a warning, not an error.

Add the maxclicks skill

The skill teaches Cursor's agent how to work with maxclicks: how to authenticate, how your schemas shape every call, when to reach for the CLI or an SDK, and which mistakes to avoid. It follows the open Agent Skills standard, so Cursor loads it like any other skill.

Install the skills in your project:

npx skills add https://maxclicks.ai

See Agent Skills for setup and the catalog. For terminal requests, install the CLI and configure your API key.

The skill catalog covers these areas:

Skill	Loads for
`maxclicks`	The entry point: auth, the data model, and the CLI/SDK/API map.
`maxclicks-contacts`	Creating, updating, or deleting contacts and objects.
`maxclicks-events`	Firing and listing events.
`maxclicks-email`	Sending templates and managing suppressions.
`maxclicks-templates`	How a template's data shape, recipient path, and sender fit together before a send.
`maxclicks-adaptyle`	Writing a template's content in Adaptyle over Liquid.
`maxclicks-segments`	Building AI-generated contact filters.
`maxclicks-broadcasts`	Scheduling and sending broadcasts, and reading their runs and metrics.
`maxclicks-deliverability`	Sending domains and saved senders, set up in the app and read over the API.
`maxclicks-topics`	Communication topics and the consent they carry.
`maxclicks-imports`	The app's bulk CSV import of contacts or objects.
`maxclicks-workflows`	Triggering workflows and observing runs.
`maxclicks-webhooks`	Managing outgoing webhooks and verifying signatures.

Which to use

Use MCP for tools the agent can call, skills for task-specific guidance, and the CLI for terminal commands. For generated application code, use an SDK or direct HTTP. These options share the same Public API.

Build

Give Cursor the agent onboarding brief. Set MAXCLICKS_API_KEY in its environment, then verify the workspace with a read:

curl --fail-with-body https://api.maxclicks.ai/v1/me \
  -H "Authorization: Bearer $MAXCLICKS_API_KEY"

Continue with the API quickstart to inspect a contact schema and upsert a test record.