How do I install Persuasion Taxonomy?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Persuasion Taxonomy need an API key?

No required environment variable is listed on this record.

What transport does Persuasion Taxonomy use?

Persuasion Taxonomy is reached over HTTP.

When was Persuasion Taxonomy last checked?

Last checked 2026-10-23. Plan and check marketing copy against the nine questions every reader asks. Free, no API key.

Persuasion Taxonomy MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://taxonomy.coppica.com/mcp

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http com.coppica-persuasion-taxonomy https://taxonomy.coppica.com/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "com.coppica-persuasion-taxonomy": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://taxonomy.coppica.com/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 1.0.7
Last checked

9 tools

Tools

tools/listVoice mode preview

Tool	What it does
plan_marketing_copy	Plan any piece of marketing copy before you write it, whether it's an ad, a landing page, a sales page or sales letter, an email, a subject line, a social post, a headline or a video script. Give it the goal, the reader and the offer, and it tells you which of the nine questions every reader silentl
diagnose_marketing_copy	Review, critique or roast any piece of marketing copy, whether it's an ad, a landing page, an email, a sales page, a social post or a script, and find out why it might not persuade. Before you call it, read the copy and label each line with the one reader question it mainly answers, quoting the word
explain_why_not_converting	Work out why an ad, a landing page, an email or a whole funnel isn't converting. Start from what you can see. Maybe people don't click (a low CTR), or they click and bounce, or they read and don't buy. Maybe they abandon the checkout or the form, the leads never buy, customers buy once and leave, or
find_persuasion_techniques	Search the Persuasion Taxonomy, 766 named persuasion techniques documented from real advertising and organized by the nine reader questions they answer. Describe what you want the copy to do, like build trust without testimonials, create urgency without fake scarcity, handle a price objection, make
get_persuasion_technique	Look up one persuasion technique by its ID (like PT-PRV-10000), its slug or its name. You get the full definition, why it works, when it lands and when it backfires, real examples from advertising, related and opposite techniques, and a link you can cite. Use it before you apply or recommend a techn
check_headlines	Check headlines, email subject lines, ad openings, video hooks, social post openings and first lines, and compare options against each other. For each line it tells you whether the line does its job in that spot, meaning which of the nine reader questions it answers, and whether a competitor could s
check_marketing_claims	Check whether marketing claims and calls to action are specific enough to believe. It catches the vague superlative, like "the best" or "#1", that readers discount on sight. It catches promises with no proof behind them and results with no mechanism, and it flags the generic buttons everyone uses, l
plan_ab_test	Plan an A/B test for marketing copy. Give it the current conversion rate, the smallest lift worth detecting and the daily traffic, and it tells you how many visitors each version needs and how many days to run. It also frames the test as two different answers to the same reader question, so the resu
read_ab_test_result	Read the result of an A/B test. You get each version's conversion rate and lift, whether the difference is statistically significant, the confidence interval, and the chance each version really beats the original. It also warns you about the things that make a test result lie. Those include too few

Persuasion Taxonomy MCP

Most AI-written marketing copy fails for the same reason. The model answers every question the reader has with the most expected move, and the most expected move is exactly what readers have learned to skim past.

This server gives your AI a better model of the reader. Everyone who reads an ad, a page or an email is silently asking nine questions:

Why am I even reading this?
Is this written for me?
How bad is my problem, really?
Am I thinking about this correctly?
Can I trust the claim?
What does my life look like after?
What's stopping me from saying yes?
Why should I act right now?
Do I like and trust who's speaking?

Copy persuades when it answers the questions its goal needs, answers them truthfully, and the answers fit together. The server helps your AI plan copy around those questions, check a draft against them before anyone sees it, and reach past the obvious move for one of 766 persuasion techniques documented from real advertising. It also does the math behind A/B tests.

It's free and needs no API key. It makes no AI calls of its own, either: your model does the thinking, and the server only serves the catalog and runs plain code.

Connect it

The hosted server lives at https://taxonomy.coppica.com/mcp. Any client that accepts a remote MCP server (Streamable HTTP) can use that URL as it is.

Claude Code

claude mcp add --transport http persuasion-taxonomy https://taxonomy.coppica.com/mcp

Claude Code plugin. This adds the server along with a short skill that tells Claude when to reach for it.

/plugin marketplace add Otha-Labs/persuasion-mcp
/plugin install persuasion-taxonomy@persuasion-taxonomy

Claude, ChatGPT and other apps with custom connectors. Add a custom connector and paste in the URL above. There's nothing to sign in to.

Cursor (.cursor/mcp.json)

{ "mcpServers": { "persuasion-taxonomy": { "url": "https://taxonomy.coppica.com/mcp" } } }

VS Code (.vscode/mcp.json)

{ "servers": { "persuasion-taxonomy": { "type": "http", "url": "https://taxonomy.coppica.com/mcp" } } }

Run it on your own machine (any client that launches local servers)

{ "mcpServers": { "persuasion-taxonomy": { "command": "npx", "args": ["-y", "@coppica/persuasion-mcp"] } } }

What your AI can do with it

You don't need to name the tools. Ask for what you want and a capable model reaches for the right one, and in testing it did so in all 16 realistic requests we tried, without being told the server existed.

When someone asks...	The tool that answers
"Write me a landing page / ad / email / sales letter"	`plan_marketing_copy` plans it around the nine questions before a word is written
"Is this good?", "Roast this", "What's wrong with this copy?"	`diagnose_marketing_copy` shows which questions the copy answers, which it skips, and what reads as machine-written
"My ad gets clicks but no sales"	`explain_why_not_converting` works back from the symptom to the question going unanswered
"Give me other ways to build trust", "Make this less generic"	`find_persuasion_techniques` searches the catalog for a less expected move
"What is this technique called?", "How does it work?"	`get_persuasion_technique` returns the full entry, with real examples and when it backfires
"Which of these headlines is best?"	`check_headlines` says what each line is betting on and which two to test
"Is this claim believable?", "Is this button any good?"	`check_marketing_claims` catches vague superlatives, unproven promises and stock buttons
"How long should I run this test?"	`plan_ab_test` sizes the test and frames it so the result teaches you something
"Did my test win?"	`read_ab_test_result` reads the result and warns you when it might be lying

It also offers four ready-made prompts (/roast, /brief, /why-not-converting and /next-test) and the nine questions as a resource you can read in full.

What it keeps

Nothing you send it. Your copy, your brief and your test numbers are used to answer that one request and then dropped. The hosted server logs which tool was called and when, and like any website, its host keeps ordinary request logs for a short time. The full policy is at taxonomy.coppica.com/privacy.

Where the techniques come from

Every technique is an entry in The Persuasion Taxonomy, a catalog of persuasion techniques documented from real ads, sales letters, emails and pages, with examples from the 1920s to now. The catalog is free under CC BY 4.0. When your AI uses a technique, it names the technique and links to its page, so your reader can see the real examples behind the advice.

Develop

npm install
npm run build
npm run smoke            # connects as a client over stdio and calls every tool
npm run smoke -- --http  # the same, over Streamable HTTP
npm run voice            # checks every model-facing string for machine tells

The catalog in data/ is a snapshot. npm run export-data refreshes it, and it needs read access to Coppica's database, so outside contributors can work against the snapshot as it is.

The src/http.ts module exports handleMcpRequest(request), which takes a web-standard Request and returns a Response. That makes it easy to host anywhere that speaks fetch: a Next.js route, a Vercel or Cloudflare function, or plain Node 18 and up.

Voice

Every word the server shows a model reads the way a good direct-response writer would write it: plain words, full sentences that lead into each other, no em dashes, no shouted labels and no "it's not X, it's Y". That goes for the instructions, the tool descriptions, every line of output and every error message. A model picks up the voice of whatever it reads and passes it on to whoever it's writing for, so the tool has to model the writing it asks for. src/voice.ts turns the scorers' findings into plain sentences, and npm run voice keeps it honest.

License

The code is MIT. The catalog data in data/ is CC BY 4.0 and belongs to The Persuasion Taxonomy by Coppica.

About

Built by Coppica. This server knows how readers think. Coppica connects that same model of the reader to your live conversion data, so over time it learns which answers actually sell to your buyers.

Persuasion Taxonomy

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Persuasion Taxonomy?

Does Persuasion Taxonomy need an API key?

What transport does Persuasion Taxonomy use?

When was Persuasion Taxonomy last checked?

Documentation

Persuasion Taxonomy MCP

Connect it

What your AI can do with it

What it keeps

Where the techniques come from

Develop

Voice

License

About