# Xylo

> Xylo is the connector that lets any AI agent run your Meta, Google, and TikTok ad accounts in plain English. Connect your accounts once, point your AI app at Xylo, then just talk to it. Hand your ad accounts to an AI agent.

- [Documentation](https://xyloapi.dev/docs)
- [Agent Playbook (full)](https://xyloapi.dev/llms-full.txt)
- [MCP Tool Reference (300+ tools)](https://xyloapi.dev/mcp-tools.md)
- [Pricing](https://xyloapi.dev/#pricing)
- [Sign Up Free](https://xyloapi.dev/auth/signup)

## What is Xylo?

Xylo is an MCP server (a connector) that plugs your AI assistant directly into your ad accounts on Meta (Facebook and Instagram), Google Ads, and TikTok Ads. You connect your accounts once, point Claude, ChatGPT, Cursor, Claude Code, Codex, or any MCP-compatible agent at Xylo, and then manage your advertising by chatting: "Launch a Reels campaign," "Why is my cost per purchase up this week?", "Send me the Friday report." The agent does the real work across all three platforms and reports back what changed.

There is no dashboard to learn, no CSV exports, and no glue code. Xylo gives the agent 300+ read and write tools that cover essentially every Ads Manager surface, so hours of account work get done in a sentence. A developer REST API exists too, but it is the secondary path.

## How it works

1. Connect in a minute: sign in, authorize Meta, Google, or TikTok via OAuth, and pick your account. Tokens are encrypted (AES-256). The agent never sees your credentials.
2. Ask in plain English. No dashboards, no exports, no code.
3. Xylo does it: the agent uses the 300+ tools to make the changes and reports back.

## Capabilities (across Meta, Google, and TikTok)

- Build and edit campaigns, ad sets / ad groups, and ads
- Adjust budgets and schedules; duplicate winners; run bulk operations
- Pull performance diagnostics and true cross-platform reports (one normalized report across all three platforms)
- AI creative analysis: hook strength, retention, messaging, and performance against your own account KPIs
- Build custom and lookalike audiences; search targeting (interests, behaviors, locations)
- Reason over a built-in Ad Creative Expert knowledge base
- Remember each account's conventions in a persistent Account Brief (naming rules, default budgets, geo and audience preferences, product sets, brand voice), so you stop repeating yourself. The agent reads it before it works and adds new facts as you share them
- TikTok coverage includes GMV Max and Smart+ campaigns

## Safety

- New campaigns are created PAUSED, so nothing spends until you approve.
- Ad account tokens are encrypted with AES-256-GCM; the agent never sees them.
- Budgets are handled in dollars, not cents.

## Connect your agent (MCP)

- MCP endpoint (all platforms): `https://xyloapi.dev/api/mcp`. Single-platform users can connect a scoped endpoint for a leaner tool set: `https://xyloapi.dev/api/mcp/meta`, `.../api/mcp/google`, or `.../api/mcp/tiktok`.
- Works with Claude (claude.ai or Claude Desktop, via Connectors), ChatGPT (any paid plan, on the web, Developer mode), Cursor, Claude Code, Codex, and anything MCP-compatible.
- Authorization uses OAuth 2.1 (PKCE). You approve account access once; the agent connects through your Xylo account.

## Pricing

- Free: $0, no credit card. 1 ad account per platform (Meta + Google + TikTok). Full MCP server and REST API. 50 tool calls per month, 3 creative analyses per month, 60 requests/min.
- Brand: $67/mo (7-day free trial). 3 ad accounts included, then $15 per extra account up to 11 total. Unlimited tool calls, 20 creative analyses/month, campaign duplication and bulk operations, permission-scoped API keys, 5 team seats, 120 req/min. Optional data-warehousing add-on $15/account. (Most popular.)
- Agency: $197/mo. 30 ad accounts included, then $12 per extra account, unlimited. Everything in Brand, plus 50 creative analyses/month, per-account scoping, team access controls, 20 team seats, 600 req/min. Warehousing add-on $10/account.

## Developer REST API (secondary)

For developers who want direct programmatic access without an agent:

- Base URL: `https://api.xyloapi.dev`
- Auth header: `x-api-key: xy_sk_...` on every request
- Platform routing: Meta endpoints under `/v1/...` (most also need `x-ad-account: act_...`), Google under `/v1/google/...` (needs `x-google-customer-id`), TikTok under `/v1/tiktok/...` (needs `x-tiktok-advertiser-id`)
- Response shape: `{ data, meta, paging? }`. Budgets in dollars. New campaigns default to PAUSED. Pass `?refresh=true` to bypass caching.

## Key pages

- [Docs](https://xyloapi.dev/docs) — connector setup for Claude, ChatGPT, Cursor, and more, plus the full REST API reference
- [Blog](https://xyloapi.dev/blog) — guides on running ads with AI agents
- [Prompt playbook](https://xyloapi.dev/prompts) — copy-paste prompts for common ad tasks
- [Meta prompts](https://xyloapi.dev/prompts/meta) — prompts for Facebook and Instagram ads
- [Google prompts](https://xyloapi.dev/prompts/google) — prompts for Google Ads
- [TikTok prompts](https://xyloapi.dev/prompts/tiktok) — prompts for TikTok ads
- [Why Claude](https://xyloapi.dev/why-claude) — why Claude is the recommended agent for Xylo
- [Changelog](https://xyloapi.dev/changelog) — what shipped, release by release
- [MCP Tool Reference](https://xyloapi.dev/mcp-tools.md) — 300+ tools with the full description each agent sees
- [Xylo Claude Skill](https://xyloapi.dev/xylo-skill.md) — the downloadable Claude skill that teaches an agent to run Xylo well

## Full agent instructions

See the complete Agent Playbook at https://xyloapi.dev/llms-full.txt for account discovery routines, daily monitoring, alert thresholds, scaling and killing rules, audience strategy, metrics benchmarks, and safety rules.