AAJ Marketing Engines
This server exposes AAJ's marketing engines and skill library to MCP clients through discovery, inspection, execution, and search tools.
list_engines: List all available marketing engines with IDs, questions they answer, and categories; optionally filter by category, ID, title, or summary.describe_engine: Inspect one engine's input schema, required fields, units, alternative input shapes, and worked example.run_engine: Run an engine deterministically on supplied inputs, or omit inputs to run its built-in demo; invalid input is rejected rather than guessed.search_skills: Find marketing skills by plain-language problem, with results marking which skills have runnable engines.get_skill: Retrieve a skill's full method, steps, quality bar, and engine usage instructions.Supports topics such as unit economics, pipeline forecasting, budget allocation, retention, A/B significance, SEO/GEO scoring, ad spend, and pricing.
The engines are read-only, offline, non-destructive, and idempotent per the schema annotations.
Provides a recipe to feed HubSpot deal data into the pipeline-and-forecast engine, enabling weighted forecasting, pipeline coverage checks against win rates, and identifying levers to improve the forecast.
Provides a recipe to use Semrush keyword data with the aaj-programmatic-seo skill to evaluate whether a template-page build pays back.
Provides a recipe to use Stripe export data with the unit-economics engine to compute gross-margin LTV, CAC payback, and whether the economics support growth.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
The math layer for marketing agents
Most marketing skills are writing instructions. They help an agent draft a page, an email or a plan, so keep them. These add the arithmetic underneath. The agent that drafts your pricing page can check whether the price still covers inference cost. The agent that writes the board update can compute the forecast instead of estimating it. Same input, same output, and code you can read.
Works with Claude Code, OpenAI Codex, Cursor, Windsurf, Cline and any agent that supports the Agent Skills spec. Free, MIT, no API key, and the engines make no network calls.
Built by Saroj Jha / AAJ. Browsable library at skills.aajconsult.com.
If an engine saves you a spreadsheet, star the repo. Stars are how other founders, and the directories agents search, find it. Questions and engine requests go in Discussions.
Renamed on Oct 11, 2026.
copywriting,marketing-psychology,programmatic-seo,marketing-loopsandsales-enablementare nowaaj-copywriting,aaj-marketing-psychology,aaj-programmatic-seo,aaj-marketing-loopsandaaj-sales-enablement. Another popular library publishes skills under the same five names, so with the prefix both install side by side. The hosted MCP server still answers to the old names.
Contents
Strategy & Positioning — 15 skills, 10 engines
Research & Personas — 4 skills, 3 engines
SEO, GEO & AEO — 10 skills, 9 engines
Content & Copy — 11 skills, 10 engines
Conversion & Web — 6 skills, 4 engines
Paid Media & Budgeting — 5 skills, 5 engines
Analytics & Experimentation — 6 skills, 6 engines
Sales & Pipeline — 13 skills, 10 engines
Retention & Lifecycle — 4 skills, 3 engines
Growth, Retention & RevOps — 10 skills, 9 engines
Related MCP server: mcp-saas-metrics
Quick start
# everything
npx skills add sarojkjha/aaj-marketing-skills
# one skill
npx skills add sarojkjha/aaj-marketing-skills --skill unit-economics
# see what's available
npx skills add sarojkjha/aaj-marketing-skills --listInstalls to .agents/skills/, and symlinks into .claude/skills/ for Claude Code.
Step-by-step instructions for every agent, Windows, Mac and Linux, and the hosted server: docs/install.md.
Then run any engine with no configuration at all:
node .agents/skills/unit-economics/resources/unit-economics.js --demoAAJ Unit Economics -- subscription
------------------------------------------------------
Gross-margin LTV $13,333 (3.0% monthly churn (~33.3 mo lifetime))
CAC $3,000
LTV : CAC 4.4:1
CAC payback 7.5 mo
[OK] LTV:CAC 4.4:1 is at or above the 3:1 floor.
[OK] CAC payback 7.5 mo is within the ~12-month guideline for subscription.Swap the demo values for your own and it works the same way.
From a clone of this repo, paths are
skills/<slug>/resources/…instead of.agents/skills/<slug>/resources/….
Install as a Claude Code or Codex plugin
Claude Code. In Claude Code 2.1.275 or later, one line adds the marketplace and opens the plugin:
/plugin install aaj-marketing-skills --marketplace sarojkjha/aaj-marketing-skillsOn earlier versions, run two commands:
/plugin marketplace add sarojkjha/aaj-marketing-skills
/plugin install aaj-marketing-skills@aajThe skills then appear as /aaj-marketing-skills:<skill>. The plugin also starts the local AAJ engines MCP server (platform/mcp/server.mjs, Node 18+), so Claude can call run_engine directly. It runs on your machine and AAJ receives nothing. Updates arrive when you run /plugin marketplace update aaj.
OpenAI Codex. Add the marketplace, then install the plugin (or browse it with /plugins inside Codex):
codex plugin marketplace add sarojkjha/aaj-marketing-skills
codex plugin add aaj-marketing-skills@aajcodex plugin marketplace upgrade aaj picks up new skills. Codex reads .agents/plugins/marketplace.json, and both clients load every skill in skills/.
Use it from an MCP client
Instead of installing the skills into a project, you can expose all 84 skills and all 69 engines to any MCP client — Claude Desktop, Claude Code, Cursor, Windsurf — as five tools:
Tool | What it does |
| Every runnable engine, grouped by category |
| One engine's input schema, units and worked example |
| Runs it on your numbers, or the demo if you pass none |
| Finds a skill by the problem, not the name |
| The full method for one skill |
Hosted, no install. Add this URL as a custom connector (a remote MCP server) in Claude, ChatGPT or any MCP client:
https://mcp.aajconsult.com/mcpNo sign-in. The server runs the engines in memory and keeps no copy of what you send (what happens to your data). In Claude: Settings → Connectors → Add custom connector. Then ask, for example, "Use the AAJ engines to check my unit economics: CAC $1,200, ARPA $300 a month, 80% gross margin, 3% monthly churn."
Local. Clone the repo and point your client at one file. Node 18+, no dependencies, no build step:
{
"mcpServers": {
"aaj-engines": {
"command": "node",
"args": ["/absolute/path/to/aaj-marketing-skills/platform/mcp/server.mjs"]
}
}
}Your agent can then find the right method for a problem and run the math on your numbers, rather than estimating. Run locally, AAJ receives nothing; your agent's model provider still sees what you give the agent.
What happens to your data
The engines are deterministic scripts. They make no network calls, write no files and take no actions in your tools; they compute and return text and JSON. Where your numbers travel depends on how you run them:
How you run it | Where your inputs go |
Skill installed in your agent, or the local MCP server | The engine runs on your machine and AAJ receives nothing. Your AI agent still sends what you give it to its model provider (Anthropic, OpenAI and so on), under your own account's terms. |
Hosted MCP server | Your agent's model provider, as above, plus AAJ's server on Cloudflare, which receives the engine inputs over HTTPS, runs them in memory and keeps no copy. Cloudflare keeps error logs (no inputs) for up to 7 days. |
Don't pass customer names, emails or other personal data to an engine; none of them needs it.
Setup for each client, troubleshooting, and the smoke test:
platform/mcp/README.md.
Recipes: vendor data in, a verdict out
Vendor MCP servers bring the data; the engines turn it into a verdict. Each recipe is a prompt to paste, a field-by-field mapping and the checks to make before you trust the result:
HubSpot deals into
pipeline-and-forecast: weighted forecast, coverage against your win rate, and the lever to pull.HubSpot contacts into
funnel-leak-finder: the stage that cost the most wins against last period.GA4 results into
ab-test-significance: sample size before the test, a verdict after it.GA4 traffic sources into
ai-referral-share: how much traffic AI assistants send, and whether it converts differently.Ahrefs or Semrush keyword data into
aaj-programmatic-seo: whether a template-page build pays back.Stripe data into
unit-economics: gross-margin LTV, CAC payback, and whether your economics support growth.Search Console data into
content-decay: which pages are decaying, and refresh priorities ranked by clicks lost.Search Console queries into
search-demand-reader: where the demand is, by intent and topic, and the gaps you already appear for.Google Ads data into
paid-search-account-audit: the spend that produced nothing, starved winners, and one fix list ranked blocking-first.Google Ads test results into
ad-creative-testing: whether a creative really won, or delivery was too uneven to say.
What a runnable engine means
Most agent skills are instructions. These are too — but 69 of them also ship a dependency-free Node script that does the arithmetic and returns a judgement.
Instruction-only skill | Skill with an engine | |
Output | Guidance the agent paraphrases | Deterministic numbers |
Reproducible | No | Yes — same input, same output |
Verifiable | You trust the model | You read the code |
Runs without an agent | No | Yes, |
Every engine accepts --demo (a worked example, no config), --help (the input schema), and a JSON payload for your own numbers. Engines validate input and fail loudly rather than returning a confident wrong answer.
The catalog
E marks a skill with a runnable engine. Phase refers to AAJ's Diagnose → Design → Execute method.
Strategy & Positioning
Skill | What it does | Phase | |
E | Diagnoses which decision friction blocks the buyer, with a line between persuasion and manipulation. | Design | |
E | Checks that an AI plan's price still covers inference when usage spikes. | Design | |
E | Picks the segment to win first from evidence, and says when the pick is still a guess. | Design | |
Builds the shared brand brief every other skill reads first. | Diagnose | ||
E | Diagnoses which play applies, then sequences the other skills in order. | Diagnose | |
E | Reads rival homepages side by side and says which claims are crowded, which are open, and whether your headline blends in. | Diagnose | |
Builds the GTM story an investor can check, from engine-run numbers. | Design | ||
E | Sizes TAM, SAM and SOM bottom-up, with SOM set by capacity rather than a share of the market. | Diagnose | |
E | Scores marketing as a system across six dimensions, and names the weak links to fix first for your stage. | Diagnose | |
Structures the message hierarchy beneath the positioning. | Design | ||
E | Produces a positioning statement pressure-tested against the competitive alternative. | Design | |
E | Designs tiers with an anchor check and a willingness-to-pay read. | Design | |
E | Scores a pricing page on 21 buyer checks, and says whether a price test can answer the question at your traffic. | Diagnose | |
Chooses self-serve, sales-led or a mix from the buyer and the unit economics, not from fashion. | Design | ||
Sharpens the value proposition into something defensible. | Design |
Research & Personas
Skill | What it does | Phase | |
E | Turns coded interview notes into ranked patterns and anecdotes, and says whether you can stop interviewing. | Diagnose | |
E | Designs surveys that produce usable answers, with sample sizing and segments. | Diagnose | |
Builds personas from evidence rather than imagination. | Design | ||
E | Codes pasted reviews of you and your rivals into themes, switching reasons, feature asks and buyer language. | Diagnose |
SEO, GEO & AEO
Skill | What it does | Phase | |
E | Models whether a template-page build pays back before anything gets written. | Design | |
E | Scores whether an AI agent buying for a customer can find, evaluate and transact with you. | Diagnose | |
E | Separates ChatGPT, Perplexity, Gemini and Copilot visits in a GA4 export, and says whether they really convert differently. | Diagnose | |
E | Sorts a Search Console export into decaying, demand-drop, snippet-loss, rising and stable pages, and ranks what to refresh by clicks lost. | Diagnose | |
E | Measures whether AI engines name and cite you, and refuses to report noise as movement. | Execute | |
Rewrites a page to maximise the chance an AI engine cites it. | Execute | ||
E | Reads a Search Console Queries export by intent and topic, and names the demand you already appear for but do not yet win. | Diagnose | |
E | Produces a writer-ready brief: intent, answer block, entities, internal links. | Design | |
E | Scores a page 0-100 across SEO, GEO and AEO, with fixes in priority order. | Diagnose | |
E | Maps schema types to pages, then checks each page's JSON-LD against Google's docs and the visible text. | Execute |
Content & Copy
Skill | What it does | Phase | |
E | Rewrites page copy to ladder to the positioning, scored on claim-defensibility. | Execute | |
E | Scores whether a team's AI use is governed, and refuses citations that cannot be checked. | Execute | |
E | Derives the measurable half of a voice guide from writing you agree sounds right, as a checkable profile. | Design | |
E | Checks content block by block against your own voice rules, with a pass/revise verdict. | Execute | |
E | Scores whether proof would convince a sceptic, and whether you may publish it at all. | Execute | |
E | Flags every claim in your copy that needs proof or consent, sentence by sentence, with the regulator's own guidance. | Execute | |
E | Builds vs and alternatives pages with sourced, dated rival facts, and checks they admit where the rival wins. | Execute | |
E | Costs a content plan in hours against real capacity, and names what to cut. | Execute | |
Turns one pillar asset into channel-adapted derivatives, reusing only what it says. | Execute | ||
E | Scores a founder's channel setup, and checks a post against the themes only they can write. | Execute | |
E | Scores a story before it is pitched, and aims it at twenty of the right people. | Execute |
Conversion & Web
Skill | What it does | Phase | |
Specs a landing page before anyone designs it. | Execute | ||
E | Scores lead-magnet and free-tool ideas on the job they do against build effort, and judges live ones on qualified leads. | Design | |
E | Reads each upgrade prompt's funnel with honest intervals and names the prompt and stage to fix first. | Diagnose | |
Picks the demo format for each buying stage and keeps AI demos honest. | Design | ||
E | Scores signup friction and ranks what to remove by what it's worth. | Execute | |
E | Audits a page for conversion friction and grades it. | Diagnose |
Paid Media & Budgeting
Skill | What it does | Phase | |
E | Sizes a creative test before it runs, and refuses to name a winner the data cannot back. | Execute | |
E | Says how much to spend, and for how long, before judging a channel - and when to stop early. | Design | |
E | Sizes a marketing budget by stage, shows where each figure comes from, and splits it by function. | Design | |
E | Splits spend across channels to hit a CAC target, with diminishing returns modelled. | Design | |
E | Audits a search account against its own target: tracking, waste, starved winners, pages. Fixes ranked by spend. | Diagnose |
Analytics & Experimentation
Skill | What it does | Phase | |
E | Checks whether an A/B result is significant, or sizes a test before you run it. | Execute | |
E | Names the stage that cost the most wins against your own baseline, never from raw drop-off, and flags changes that may be noise. | Diagnose | |
E | Designs and reads holdout tests honestly, including whether they could ever have answered. | Diagnose | |
E | Turns funnel, spend and pipeline numbers into a board-ready narrative. | Execute | |
E | Magic number, burn multiple, Rule of 40 and CAC payback, each read against its source's own words. | Diagnose | |
E | Computes LTV, CAC, payback and the ratio, then returns a verdict against named reference points. | Diagnose |
Sales & Pipeline
Skill | What it does | Phase | |
E | Audits sales assets against what each deal stage needs, and ranks what to build by the revenue being lost. | Execute | |
E | Checks whether the team can run the account list and whether the list hits the number. | Design | |
E | Maps who must say yes, what each must believe, and who you cannot reach, then orders the next conversations. | Design | |
Writes outbound sequences that survive a reply-rate audit. | Execute | ||
Structures discovery so the call qualifies rather than pitches. | Execute | ||
E | Checks whether MQLs get worked on time, whether sales takes them, and whether the threshold is in the right place. | Execute | |
E | Builds responses to the objections that lose deals, and checks the battlecard before reps use it. | Design | |
E | Plans a pilot backwards from the buyer's budget date, so a pilot that works becomes a contract. | Design | |
E | Weights pipeline by stage and says whether coverage is real. | Execute | |
E | Turns a revenue target into the leads, MQLs, SQLs, opportunities and wins it takes, from your own rates. | Design | |
Designs the stages and exit criteria a forecast can rely on. | Design | ||
E | Scores and tiers accounts by ICP fit, showing the signals each matched. | Design | |
E | Finds the Pareto of why deals are actually lost, by revenue. | Diagnose |
Retention & Lifecycle
Skill | What it does | Phase | |
E | Chains cohorts of different ages into one retention curve, finds where it levels off and tests newer cohorts against older ones. | Diagnose | |
E | Maps which lifecycle sequences exist, checks send load, writes the missing ones. | Execute | |
E | Computes churn, NRR, GRR and quick ratio, then diagnoses which one to fix. | Design | |
Defines the activation moment from data and finds where new users stall. | Execute |
Growth, Retention & RevOps
Skill | What it does | Phase | |
E | Computes the loop factor, finds the throttling stage, projects users over time. | Design | |
E | Maps where buyers already talk, decides whether to open your own community, and measures dark social by asking. | Execute | |
E | Pays creators for the buyers they reach, not their follower count, and judges the result on what it sold. | Execute | |
Treats docs and the first working call as the marketing, and measures it. | Design | ||
E | Writes the first marketer's scorecard, then scores the panel's evidence and calls hire, no-hire or more evidence. | Design | |
E | Prices in-house, fractional and agency with ramp, search time and your own hours, and says which shape fits. | Diagnose | |
E | Scores partners on audience overlap rather than fame, and judges the result on pipeline. | Execute | |
E | Tiers a launch, scores readiness on a twelve-item gate, and builds the dated work-back plan. | Execute | |
E | Designs who to ask and what to reward, then prices referral against the CAC it replaces. | Design | |
E | Sizes a webinar backwards from the pipeline it must create, and judges it on meetings and pipeline against cost. | Execute |
Engines at a glance
Every runnable engine, and the command to try it:
Skill | Command |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Methodology
Every skill is tagged to a phase, and the ordering is deliberate — the catalog refuses to let you execute before you have diagnosed.
Diagnose (24 skills) — find out what is actually broken before choosing a fix.
Design (30 skills) — decide the approach, with the trade-offs stated.
Execute (30 skills) — build and ship it.
If you do not know where to start, campaign-orchestrator diagnoses which play applies and sequences the rest for you.
New to the catalog? Run brand-product-context first. It builds the shared brief every other skill reads.
Authoring & contributing
See AUTHORING_GUIDE.md for the standard every skill follows, and SKILL_TEMPLATE.md to start a new one.
Credits & license
MIT — use freely, commercially or otherwise.
Built by Saroj Jha / AAJ, a marketing consultancy for Seed–Series B startups. The Agent Skills spec and Corey Haines' coreyhaines31/marketingskills (MIT) were references for structure and topic coverage; all AAJ skills are independently written and grounded in AAJ's own tools and methodology.
Available Tools
5 toolsdescribe_engineDescribe an engine's inputsARead-onlyIdempotentInspect
Shows one engine's input schema: required fields, units, alternative shapes, and a worked example. Engines reject bad input rather than guessing.
Inputs: engine (required).
get_skillGet a skill's methodARead-onlyIdempotentInspect
Returns the full method for one skill: when to use it, the steps, the quality bar, and how to run its engine if it has one.
Inputs: skill (required).
list_enginesList marketing enginesARead-onlyIdempotentInspect
Lists every AAJ marketing engine: its id, the question it answers, and its category. Engines cover unit economics, pipeline forecast, budget allocation, retention, A/B significance, SEO/GEO scoring, ad spend and pricing.
Inputs: category.
run_engineRun a marketing engineARead-onlyIdempotentInspect
Runs an AAJ engine and returns its verdict. Give input as an object of the engine's fields. Omit input to run the engine's built-in worked example. Engines are deterministic, offline, and validate their input — a wrong unit is reported as an error, not absorbed into a confident answer.
Inputs: engine (required), input.
search_skillsFind a marketing skillARead-onlyIdempotentInspect
Finds AAJ marketing skills by the problem they solve — 'churn is rising', 'we're launching next month', 'not showing up in AI answers'. Returns matching methods and marks which have a runnable engine.
Inputs: query (required), limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a distinct role: list/search for discovery, get_skill/describe_engine for detail, run_engine for execution. The only mild friction is the two overlapping entity layers (skills vs. engines) — get_skill mentions running an engine while describe_engine shows the engine schema — but the verb distinguishes intent clearly enough.
All five tools follow a strict verb_noun snake_case pattern (run_engine, search_skills, get_skill, list_engines, describe_engine). The convention is applied uniformly with no deviations in casing or style.
Five tools is well-scoped for a server exposing two related entity types: discovery (list_engines, search_skills), detail (get_skill, describe_engine), and execution (run_engine). No tool feels redundant, and none is missing at this granularity.
The lifecycle is largely covered: find skills, inspect a skill, list/describe/run engines. Minor gaps exist — no plain 'list all skills' without a problem query, and no batch or multi-engine run — but these are workable around since skills are discoverable via search_skills.
Maintenance
Related MCP Connectors
116 marketing, RevOps and SaaS calculators with benchmarks, guided reviews, content search, booking.
Deterministic what-if & scenario simulation for AI agents: projections, sensitivity & break-even.
Find and run exact business, finance and SaaS calculators instead of guessing the math.
Deterministic finance tools for AI agents — IRR, NPV, MOIC, DCF, WACC and sensitivity.
Related MCP Servers
- AlicenseAqualityBmaintenance63 deterministic quant computation tools for autonomous financial agents. Options pricing, derivatives, risk metrics, portfolio optimization, statistics, crypto/DeFi, macro/FX, time value of money. 1,000 free calls/day, no signup required.7414MIT
- AlicenseNot gradedqualityDmaintenanceProvides accurate SaaS metrics calculations (LTV, CAC, runway, health score, etc.) with formulas and interpretations for AI agents and founders, ensuring no hallucinated numbers.MIT
- FlicenseNot gradedqualityDmaintenanceEnables precise financial analysis of AI agent costs, including token pricing, multi-step run estimates, model comparison, and ROI versus human labor, with deterministic decimal math.-
- AlicenseAqualityBmaintenanceEnables AI assistants to plan, diagnose and improve marketing copy by checking it against the nine questions every reader asks, drawing on a catalog of 766 techniques documented from real advertising, and running A/B test sizing and result math. It serves the catalog and plain code only, requiring no API key and making no AI calls of its own.9633 npm1MIT