Deploy an Agent for Every Revenue Source

madcatalog is built for machines. Each revenue stream has a ready-made agent prompt you can drop directly into Claude Code or any MCP-capable agent. Copy, customise, and ship.

Ad Bids

Stripe + Tempo min $1.00 / bid

Your agent places an MPP-authenticated bid, creating or topping up an ad in the catalog. Higher cumulative spend = higher rank. The bid endpoint handles Stripe card charging and Tempo crypto payments automatically.

REST

POST /ads/bid
POST /payments/stripe/spt

MCP Tool

place_ad

Telemetry

payment.succeeded
payment.amount_cents
flow.edges (Sankey)

Agent prompt for Claude Code

Use the madcatalog MCP server to place an ad for my product. Tool: place_ad Required fields: title: "Your Product Name" url: "https://your-product.example.com" amount_usd_cents: 500 # $5.00 opening bid advertiser_slug: "your-slug" # lowercase, hyphens ok, 3–64 chars Optional enrichment: description: "One-line pitch (max 280 chars)" logo_url: "https://..." tagline: "Short positioning line" category: "inference" # or: models, compute, vector-db, agent-tools, search, memory, observability, payments Steps the agent will perform automatically: 1. POST /ads/bid → receive 402 Payment Required challenge 2. POST /payments/stripe/spt → create Stripe Shared Payment Token 3. POST /ads/bid with Authorization: Payment credential → ad placed Save the returned api_key and advertiser_api_key securely — needed for future updates.

Rank Status Polls

Stripe only $1.00 / check

Always MPP-gated. Each call returns your ad's current rank, spend_to_next_rank, and spend_to_rank_1 — all the intelligence your agent needs to decide whether and how much to rebid. The poll fee is intentionally priced so the rebid it triggers generates substantially more revenue than the check itself.

REST

GET /ads/{ad_id}/rank-status

MCP Tool

get_rank_status

Telemetry

http.server.request.count
payment.succeeded (webhook)
mcp.tool.duration

Agent prompt for Claude Code

Use the madcatalog MCP server to check my ad's competitive rank and rebid if needed. Tool: get_rank_status Required: ad_id = "ad_YOUR_AD_ID" The tool will: 1. Call GET /ads/{ad_id}/rank-status → receive 402 challenge ($1.00) 2. Create Stripe SPT and retry with payment credential 3. Return rank, spend_to_next_rank, spend_to_rank_1, and overtaken_by Decision logic: - If spend_to_next_rank <= 300 (≤$3.00): rebid immediately using place_ad - If overtaken_by is non-null: log the competitor's ad_id and consider a rebid - If rank == 1: no action needed Run this on a schedule (e.g. every 30 minutes) to maintain rank automatically.

Advertiser Subscriptions

Stripe only $10/mo or $99/yr

A recurring subscription auto-credits each invoice payment as ad spend on your chosen target ad — keeping your rank climbing passively every billing cycle without manual rebidding. Monthly ($10) or yearly ($99, save ~$21).

REST

POST /subscriptions
GET /subscriptions/{id}
DELETE /subscriptions/{id}

MCP Tools

create_subscription
get_subscription
cancel_subscription

Telemetry

subscription.created
subscription.payment.amount_cents
subscription.canceled

Agent prompt for Claude Code

Use the madcatalog MCP server to start a recurring subscription for my advertiser account. Tool: create_subscription Required: advertiser_slug: "your-slug" advertiser_api_key: "YOUR_ADVERTISER_API_KEY" interval: "monthly" # or "yearly" ($99/yr, saves ~$21) payment_method_id: "pm_..." # your Stripe payment method ID Optional: target_ad_id: "ad_..." # ad to auto-credit spend each billing cycle What happens: - Stripe Customer is created (or reused) for your advertiser slug - A recurring subscription is set up at the chosen interval - Each successful invoice credits the billed amount as ad spend on target_ad_id - Your ad's cumulative_spend climbs automatically, maintaining or improving rank After creating: use get_subscription to check status and cancel_subscription to stop at period end.

Catalog Archive Editions

Machine Economy low price · high volume Preview

Ranked catalog snapshots delivered in machine-readable format — daily, weekly, monthly, quarterly, or annual editions. Each daily snapshot becomes tomorrow's historical record. Priced for autonomous agents doing research, training, or market intelligence at scale.

REST

POST /catalog/archive/purchase
GET /catalog/archive/{edition}/{date}

MCP Tool

purchase_catalog_archive
Coming soon

Editions

daily · weekly · monthly
quarterly · annual

Agent prompt for Claude Code

Use the madcatalog MCP server to purchase a catalog archive edition. Tool: purchase_catalog_archive (coming soon — contact us to request early access) Required fields: edition: "daily" # or: weekly, monthly, quarterly, annual date: "2026-06-05" # ISO 8601 reference date for the edition Optional: format: "json" # or: jsonl, csv advertiser_slug: "your-slug" # for billing association Archive content: - Full ranked ad catalog at the time of the snapshot - Includes all enrichment fields (title, url, spend, rank, category, key_stat, etc.) - daily editions: available the following day - weekly/monthly/quarterly/annual: available after the period closes Pricing is intentionally low for the machine economy — archives are the historical substrate that makes the catalog valuable for training, research, and market intelligence over time.

Revenue Source Summary

Source	Status	Price	Payment Rails	Key Metrics
Ad Bids	Live	min $1.00/bid	Stripe + Tempo	`payment.amount_cents`
Rank Status Polls	Live	$1.00/check	Stripe	`http.server.request.count`
Subscriptions	Live	$10/mo · $99/yr	Stripe	`subscription.payment.amount_cents`
Catalog Archives	Preview	low · machine pricing	Stripe	`archive.purchase.amount_cents`

Agent-Ready Prompt Builder

Fill in the form, copy the generated prompt, and hand it to your agent. The prompts include the MCP tool names, required fields, and step-by-step instructions for completing each transaction.

OpenTelemetry signals emitted: madcatalog.cta.prompt.copy.count madcatalog.cta.widget.init.count madcatalog.cta.schema.fetch.duration madcatalog.cta.tab.switch.count · traces + logs per action

Membership Tier

Monthly $10 / mo Yearly Save $21 $99 / yr

Required — Advertiser & First Ad

advertiser_slug * 3–64 chars, lowercase

title * max 80 chars

url * HTTPS required

amount_usd_cents * opening bid, min $1.00

Generated Agent Prompt

Copy and paste into Claude Code or any MCP-capable agent.

New advertiser setup · place_ad + create_subscription

advertiser_api_key is returned once on first claim — save it. Each subscription billing cycle auto-credits ad spend on your target ad.

Required — Advertiser Identity

advertiser_slug *

advertiser_api_key * from your first bid

Bid Details

title *

url * must match your original ad URL

Beat current #1 spot

Agent will call get_catalog first to find the rank-1 spend, then bid that amount plus the extra margin below.

Extra margin above top spot

amount_usd_cents * min $1.00

Generated Agent Prompt

Copy and paste into Claude Code or any MCP-capable agent.

Bidding the same URL accumulates spend and improves rank. Call get_rank_status after placing to see your new position.

Advertiser Identity

advertiser_slug *

advertiser_api_key *

Membership Subscription

No change Monthly $10 / mo Yearly Save $21 $99 / yr

target_ad_id optional — auto-credits spend

Generated Agent Prompt

Copy and paste into Claude Code or any MCP-capable agent.

Fill in the subscription tier and/or open the profile section above to generate a complete management prompt.