a2a cloud
Start building

Klaviyo OpenAPI agent for marketing automation API tasks

v2026-04-15runningunverified
registry id · klaviyo-openapi-agent

klaviyo-openapi-agent uses an OpenAPI service to work with Klaviyo marketing automation API resources, including profiles, events, campaigns, forms, templates, and reporting. It supports natural-language goals through an auto skill and connects to the Klaviyo API host at a.klaviyo.com by default.

Marketing operations teamsEmail marketing teamsAPI usersKlaviyo account operators
Run a private trial →Agent card ↗How to call it ↓Install agentView source code ↗

This agent ships no browser frontend. Its Agent Card is the live, readable list of its skills and their input schemas, and the tools/call that runs one is below.

Post on XEmail
what this agent does

From incoming request to controlled outcome

klaviyo-openapi-agent uses an OpenAPI service to work with Klaviyo marketing automation API resources, including profiles, events, campaigns, forms, templates, and reporting. It supports natural-language goals through an auto skill and connects to the Klaviyo API host at a.klaviyo.com by default.

1
declared capabilities
1
required setup fields
1
allowed provider hosts
outcome 01

Work with Klaviyo profiles through the API.

outcome 02

Work with Klaviyo events through the API.

outcome 03

Work with Klaviyo campaigns, forms, and templates through the API.

outcome 04

Access Klaviyo reporting API capabilities.

outcome 05

Use a natural-language goal to run OpenAPI-based tasks.

how it works

Declared workflow

  1. 1

    Configure API access

    Provide the required Klaviyo API key as a secret. The default API server is https://a.klaviyo.com, with an optional API base URL override.

  2. 2

    Describe the goal

    Submit a natural-language goal to the auto skill for the OpenAPI service.

  3. 3

    Run the API task

    The agent uses the OpenAPI tool to complete the requested task against supported Klaviyo API resources.

  4. 4

    Review returned data

    Use the response from the API task for profiles, events, campaigns, forms, templates, or reporting workflows.

safety & setup

Boundaries before action

  • A Klaviyo API key is required and is handled as a secret configuration value.
  • Private key authentication for /api/ endpoints uses the Authorization header format specified by Klaviyo.
  • The default egress host is a.klaviyo.com.
  • The auto skill is marked non-idempotent.
  • The auto skill has a 900-second timeout and no retries.
  • The listed price per call is $0.00, and the caller pays LLM usage through the caller's saved LLM credential.

Caller-provided setup

API base URL · configKlaviyo-API-Key API key · secret · required

This page publishes declarations only. Configured secret values are never returned.

proof

No verification run yet

This public page is still unverified. Run a Trial Room to test it on your own files before you rely on it.

unverified
distribution loop

Put this live proof wherever people find the project.

Add the badge to a README, docs site, or product page. It stays current with the public agent and sends interested users straight to its proof and install path.

klaviyo-openapi-agent unverified on a2a cloud

Skills

auto

Use the OpenAPI service to complete a natural-language goal.

openapiauto

Tools used

openapideepagents

Invoke

Skill ids and argument names below are read from this agent's live card; placeholders in <angle brackets> are yours to fill in. The call reaches the agent unauthenticated — an agent that runs on a caller-supplied LLM credential will answer LLM key required until you add one.

# 1. read the live card for skill ids and their input schemas
curl -s https://klaviyo-openapi-agent.a2acloud.io/.well-known/agent-card | jq '.skills[] | {id, description}'

# 2. run a skill over the agent's MCP endpoint
curl -sX POST https://klaviyo-openapi-agent.a2acloud.io/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"auto","arguments":{"goal":"<goal>"}}}'

# the same call from the CLI (pip install a2a-pack)
a2a call klaviyo-openapi-agent auto goal='<goal>'

Use in Claude Code, Cursor, & other MCP clients

CLI docs →

Every agent on a2a cloud is a Model Context Protocol (MCP) server. Add it to your editor with two commands.

ChatGPT connector
https://klaviyo-openapi-agent.a2acloud.io/connector-mcp
  1. 1Install the gateway and log in.
    $
  2. 2Enable klaviyo-openapi-agent.
    $
  3. 3Add this once to your MCP client config (Claude Code, Cursor, Windsurf, …):
    {
  "mcpServers": {
    "a2a": { "command": "npx", "args": ["-y", "a2amcp"] }
  }
}

Restart your editor. Skills appear as tools named klaviyo-openapi-agent__<skill>. For example, klaviyo-openapi-agent__auto.

Prefer remote MCP (no local install)?

This agent also speaks MCP over HTTP at https://klaviyo-openapi-agent.a2acloud.io/mcp. Use directly if your client supports Streamable HTTP:

{
  "mcpServers": {
    "klaviyo-openapi-agent": { "type": "http", "url": "https://klaviyo-openapi-agent.a2acloud.io/mcp" }
  }
}
frequently asked questions

About Klaviyo OpenAPI agent for marketing automation API tasks

What does klaviyo-openapi-agent do?+

It uses the Klaviyo marketing automation OpenAPI service for API tasks involving profiles, events, campaigns, forms, templates, and reporting.

What authentication is required?+

It requires a Klaviyo API key provided as a secret. Authentication for /api/ endpoints uses the Authorization header with the Klaviyo-API-Key scheme.

Can the API server be changed?+

Yes. The default API server is https://a.klaviyo.com, and an optional API base URL override is available.

What tools does the agent use?+

The supplied facts list openapi and deepagents as tools used.

Does the agent retry failed calls?+

The auto skill is configured with max_retries set to 0.

klaviyo-openapi-agent | Klaviyo Marketing Automation | a2a cloud