Cypher Ad Intelligence for Claude Code

A read-only competitive ad-intelligence companion for Claude Code over a linked Cypher account.

What it is

The plugin searches Cypher's existing first-party Meta ad corpus. It does not scrape Meta at call time. Writes stay on cypherapp.io — save and organise swipefile, boards, and tracked brands there.

Plugin MCP origin (OAuth, text only): https://mcp.cypherapp.io/mcp

Prerequisites

An existing Cypher account (signup is waitlist-gated; not in-plugin) and Claude Code 2.1.2 or later (the 2.1.2xx series).

Install

Marketplace id is cypher-plugins; plugin id is cypher (install is cypher@cypher-plugins):

/plugin marketplace add <org>/cypher-claude-plugins

/plugin install cypher@cypher-plugins

Restart Claude Code or run /reload-plugins after install.

Local dev from the cypher-app repo root: claude --plugin-dir ./plugins/claude/cypher. A --plugin-dir copy shadows a same-named installed plugin for the session. Optional in-repo marketplace add: /plugin marketplace add ./plugins/claude.

OAuth-link flow

The first tool call opens the system browser. Sign in with Continue with Cypher (provisional: this is the documented Universal Login control; the live button label is pending a completed Claude Code link), consent, and the plugin is linked to your existing Cypher account. No API key is required.

To relink, run /mcp and choose Re-authenticate.

Read-only tool surface

Seventeen catalog tools. The plugin is read-only: it does not write to your swipefile, boards, or tracked brands. Organise those on cypherapp.io.

discovery

• discover_ads — search Cypher's ad corpus with filters and a cursor.
• search_brands — find brands by name or domain fragment.
• explore_brands — rank brands by measured ad count.
• get_ad — look up one ad by id.
• get_ad_duplicates — near-duplicates sharing the same media URL.
• get_brand_ads — ads for a brand.
• get_brands_by_domain — exact-host brand lookup.
• get_brand_analytics — daily analytics spine for a brand.
• analyze_creative — read-only copy audit of supplied ad text.

library

• get_swipefile_ads — read your saved ads.
• list_boards — list your boards.
• get_board_ads — ads on an owned board.
• get_board_brands — brands on an owned board.
• list_tracked_brands — brands you already track.
• get_tracked_brand — one tracked brand.
• get_tracked_brand_ads — ads for a tracked brand.

account

• get_usage — this month's remaining allotment for the linked account.

Skills

• /cypher:ad-intelligence — full loop: discovery, teardown, creative audit, library review.
• /cypher:competitor-teardown — brand teardown; example /cypher:competitor-teardown Nike.

Credits

your linked Cypher account's monthly credits apply. Exhaustion is informational and the allotment resets on the first of the UTC month. Plans and credits are managed on cypherapp.io.

Revoke

On /api-mcp, delete the plugin key. Relink via /mcp → Re-authenticate.

Do not mix rails

The plugin origin is https://mcp.cypherapp.io/mcp (OAuth). The keyed https://cypherapp.io/api/mcp path plus claude mcp add documented on /developers is the API-key + x402 rail and is not this plugin.