@coppica/persuasion-mcp 1.0.2 → 1.0.3

package/dist/format.d.ts

@@ -1,5 +1,9 @@
 import type { Technique, Example } from './data.js';
 export declare const FOOTER: string;
+/** Links a reader follows out of an answer carry utm_source=mcp, so the Taxonomy's analytics can
+ *  count the visits that arrive through an AI assistant. Citations and the CC BY footer stay clean,
+ *  because people paste those into their own work. */
+export declare function tracked(url: string): string;
 export declare function text(body: string): {
     content: {
         type: "text";

package/dist/format.js

@@ -2,6 +2,12 @@ import { tierIn } from './data.js';
 import { clipText, innerQuotes } from './voice.js';
 export const FOOTER = '\n\n---\nFrom the Persuasion Taxonomy by Coppica, free to use under CC BY 4.0 at https://taxonomy.coppica.com. ' +
     'When you use a technique, name it and link to it, so your reader can see the real examples behind it.';
+/** Links a reader follows out of an answer carry utm_source=mcp, so the Taxonomy's analytics can
+ *  count the visits that arrive through an AI assistant. Citations and the CC BY footer stay clean,
+ *  because people paste those into their own work. */
+export function tracked(url) {
+    return `${url}${url.includes('?') ? '&' : '?'}utm_source=mcp`;
+}
 export function text(body) {
     return { content: [{ type: 'text', text: body + FOOTER }] };
 }
@@ -46,5 +52,5 @@ export function techniqueLine(t, opts = {}) {
     }
     if (opts.after)
         line += ` ${opts.after}`;
-    return `${line} ${t.url}`;
+    return `${line} ${tracked(t.url)}`;
 }

package/dist/server.js

@@ -4,6 +4,7 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { ROLE_NAMES, ROLES } from './roles.js';
 import { TECHNIQUES, CATALOG_META } from './data.js';
 import { cap } from './voice.js';
+import { tracked } from './format.js';
 import { registerPlanTool } from './tools/plan.js';
 import { registerDiagnoseTool } from './tools/diagnose.js';
 import { registerWhyTool } from './tools/why.js';
@@ -36,14 +37,14 @@ function nineQuestionsDoc() {
     const lines = [
         '# The nine reader questions',
         '',
-        'From The 18 Theses, Thesis VIII: https://taxonomy.coppica.com/the-18-theses',
+        `From The 18 Theses, Thesis VIII: ${tracked('https://taxonomy.coppica.com/the-18-theses')}`,
         '',
         'Everyone who reads an ad, a page or an email is silently asking nine questions. Copy persuades when it answers the ones its goal needs, truthfully, and the answers hold together.',
         '',
     ];
     for (const r of ROLE_NAMES) {
         const i = ROLES[r];
-        lines.push(`${i.num}. **${i.question}** (${r}) This one is about ${i.gloss}. Leave it unanswered and here is what happens: "${i.ifMissing}" https://taxonomy.coppica.com/${r.toLowerCase()}`);
+        lines.push(`${i.num}. **${i.question}** (${r}) This one is about ${i.gloss}. Leave it unanswered and here is what happens: "${i.ifMissing}" ${tracked(`https://taxonomy.coppica.com/${r.toLowerCase()}`)}`);
     }
     lines.push('', 'Real persuasion happens when every question a piece needs is answered, in the same person, at the same time, and the answers agree with each other. ' +
         'When one answer contradicts another, the reader feels that something is off, and they discount everything.');

package/dist/tools/catalog.js

@@ -2,7 +2,7 @@ import { z } from 'zod';
 import { ROLES, roleLabel } from '../roles.js';
 import { searchTechniques, lookupTechnique, resolveCategory, TECHNIQUES } from '../data.js';
 import { formatSchema, categorySchema, roleSchema } from '../schemas.js';
-import { text, errorText, techniqueLine, usageSentence, exampleSource } from '../format.js';
+import { text, errorText, techniqueLine, usageSentence, exampleSource, tracked } from '../format.js';
 import { joinList, clipText, innerQuotes } from '../voice.js';
 export function registerCatalogTools(server) {
     server.registerTool('find_persuasion_techniques', {
@@ -55,7 +55,7 @@ export function registerCatalogTools(server) {
         const cat = resolveCategory(category);
         const out = [];
         out.push(`# ${t.name} (${t.pt_id})`);
-        out.push(`It answers ${roleLabel(t.role)}, which is about ${ROLES[t.role].gloss}. ${usageSentence(t, cat)} ${t.url}`);
+        out.push(`It answers ${roleLabel(t.role)}, which is about ${ROLES[t.role].gloss}. ${usageSentence(t, cat)} ${tracked(t.url)}`);
         out.push('');
         // Catalog fields: whole sentences only (the export cuts long fields), and condition lists read as sentences.
         const prose = (s) => clipText(s.replace(/;\s+(?=[A-Z])/g, '. '), 4000);

package/dist/tools/plan.js

@@ -2,7 +2,7 @@ import { z } from 'zod';
 import { ROLE_NAMES, ROLES, GOAL_REQUIREMENTS, GOAL_NOUN, GOAL_CLAUSE, FORMAT_LABEL, AWARENESS_WEIGHT, COHERENCE_CHECKS, expectedRoles, roleLabel } from '../roles.js';
 import { pickMoves, resolveCategory } from '../data.js';
 import { goalSchema, formatSchema, awarenessSchema, categorySchema, modeSchema } from '../schemas.js';
-import { text, techniqueLine } from '../format.js';
+import { text, techniqueLine, tracked } from '../format.js';
 import { cap, joinList } from '../voice.js';
 const NUM = ['no', 'one', 'two', 'three', 'four', 'five', 'six', 'seven', 'eight', 'nine'];
 export function registerPlanTool(server) {
@@ -78,7 +78,7 @@ export function registerPlanTool(server) {
             lines.push(`${cap(GOAL_NOUN[goal])} doesn't strictly need these, but one well-placed line can still help.`);
             for (const role of optional) {
                 const [p] = pickMoves(role, { n: 1, format, category: cat, seed, context, mode, exclude: used });
-                lines.push(`- ${roleLabel(role)}${p ? ` One way in is **${p.t.name}** (${p.t.pt_id}). ${p.t.url}` : ''}`);
+                lines.push(`- ${roleLabel(role)}${p ? ` One way in is **${p.t.name}** (${p.t.pt_id}). ${tracked(p.t.url)}` : ''}`);
             }
         }
         const checks = COHERENCE_CHECKS.filter((c) => expected.has(c.roles[0]) && expected.has(c.roles[1])).slice(0, 4);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coppica/persuasion-mcp",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "A free MCP server that helps any AI write and check marketing copy: the nine questions every reader asks, 766 persuasion techniques from real ads, copy diagnostics and A/B test math. No API key, no AI calls.",
   "mcpName": "com.coppica/persuasion-taxonomy",
   "type": "module",