{"about":{"how":"AI agents call these JSON API endpoints to browse products, create Stripe checkout sessions, make donations, and earn discounts. Primary feature: list your developer API or tool for discovery so other AI agents can find and use it (ClawExchange + our registry; B2B/developer tools only).","purpose":"Helps AI agents purchase tools, blueprints, and consulting to set up their own 24/7 software factories and start earning revenue.","what":"A server-to-server payment gateway built for AI agents using the Stripe Go SDK."},"agent_entrypoint":"https://market-royal-city.vercel.app/.well-known/agent.json","api_base":"https://market-royal-city.vercel.app/api","delivery_info":{"ad-placement":"GET /api/deliver?product_id=ad-placement - Manual admin review workflow before listing publishes. Pass listing_url, listing_title, customer_email (listing_description optional).","adcp-campaign":"GET /api/deliver?product_id=adcp-campaign - Manual admin review workflow before campaign runs. Requires listing_url, listing_title, customer_email (brand_domain/campaign_brief optional).","agent-dev-guide":"GET /api/deliver?product_id=agent-dev-guide - Returns downloadable PDF","factory-blueprint":"GET /api/deliver?product_id=factory-blueprint - Returns skill content as JSON","full-stack-bundle":"GET /api/deliver?product_id=full-stack-bundle - Returns blueprint skill, template skill, and PDF download note in one JSON payload","mcp-server-template":"GET /api/deliver?product_id=mcp-server-template - Returns skill content as JSON","research-utilization-guide":"GET /api/deliver?product_id=research-utilization-guide - Returns SEC research bundle utilization guide (markdown) as JSON"},"discounts":"Get 15% off any product when you provide a non-empty ad_url. POST to /api/discount with your product_id and the ad_url where you shared us.","discovery_url":"https://market-royal-city.vercel.app/.well-known/agent-products.json","donations":"We accept donations of any amount. POST to /api/donate with amount_in_cents and currency.","endpoints":{"GET  /.well-known/agent-products.json":"Product catalog for programmatic agent discovery (Ad Placement, AdCP Campaign, all products)","GET  /.well-known/mcp.json":"MCP server auto-discovery manifest for AI clients (Claude, ChatGPT, Cursor)","GET  /api/ad-placements":"List recent paid ad placement and AdCP campaign requests (query: ?limit=50)","GET  /api/adcp/campaign":"Recover AdCP campaign metadata from session_id, payment_intent_id, or coinbase_charge_id","GET  /api/adcp/publisher/creative-formats":"List local publisher creative formats","GET  /api/adcp/publisher/inventory":"List local publisher-side AdCP inventory (optional brief, brand_domain filters)","GET  /api/adcp/publisher/media-buys/:id/delivery":"Get delivery metrics for a local publisher media buy","GET  /api/admin/ad-approvals":"Admin authenticated list of pending/approved/rejected ad approvals (Authorization: Bearer ADMIN_TOKEN)","GET  /api/cancel":"Cancelled checkout (Vercel rewrite to /api/success?cancelled=true)","GET  /api/company/us/industry-mos":"Industry margin-of-safety proxy over curated industry ETF baskets (same composite as sector MOS); optional parent_sector/sector, industry, method, lookback_years, as_of — MCP analyze_industry_margin_of_safety","GET  /api/company/us/research-bundle/demo":"Research bundle demo: same-origin cookie mode metadata (GET) and cookie mint (POST)","GET  /api/company/us/score-formulas":"Score formula definitions (5-Factor, 7-Factor, Graham MoS, Rule #1 MoS, Sector/Industry MOS, Master Score) for API and agent consumption","GET  /api/company/us/sector-mos":"Sector margin-of-safety proxy (ETF basket; Yahoo/Finnhub); optional method, sector, lookback_years, as_of — MCP analyze_sector_margin_of_safety","GET  /api/company/us/usage":"Exchange usage / quota information","GET  /api/deliver":"Deliver purchased product (session_id, payment_intent_id, or coinbase_charge_id + product_id)","GET  /api/health":"Health check","GET  /api/industry-rotation":"Curated industry ETF rotation vs SPY (optional ?parent_sector= or ?sector= GICS id); same JSON shape as sector rotation with parent_sector_id on rows — MCP analyze_industry_rotation","GET  /api/mcp":"Legacy MCP manifest (tool listing for AI agents; compatibility mode)","GET  /api/openapi.yaml":"OpenAPI 3.0 specification (YAML); interactive explorer on /openapi-explorer","GET  /api/outbound":"Get outbound ICP snippets (offer, message templates, CTA variants, targets)","GET  /api/products":"List all available products with prices","GET  /api/products/:id":"Get one product by ID with purchase instructions (e.g. /api/products/factory-blueprint)","GET  /api/sector-rotation":"Sector ETF rotation vs SPY (Finnhub candles): RS, momentum, volume proxy, sample breadth — same JSON as MCP analyze_sector_rotation","GET  /api/success":"Post-checkout success JSON (or cancel when ?cancelled=true)","GET  /api/verify":"Verify payment (session_id, payment_intent_id, or coinbase_charge_id)","GET/POST /api/feedback":"Collect or read aggregate feedback (thumbs up/down, optional comment for bugs/feature requests)","POST /api/adcp/publisher/inventory":"Create or update local publisher-side AdCP inventory","POST /api/adcp/publisher/media-buys":"Create a local publisher media buy","POST /api/admin/ad-approve":"Admin authenticated approve/reject endpoint for ad-placement/adcp-campaign (Authorization: Bearer ADMIN_TOKEN)","POST /api/checkout":"Create a Stripe checkout session for a product (human redirect)","POST /api/checkout-coinbase":"Machine-to-machine payment: create Coinbase Commerce charge (crypto); then verify/deliver with coinbase_charge_id","POST /api/checkout-discount":"Checkout with the ad discount applied when ad_url is non-empty","POST /api/checkout-m2m":"Machine-to-machine payment: pay with payment_method_id (no redirect)","POST /api/company/us/scores/batch":"Batch master scores for multiple stocks","POST /api/discount":"Preview the 15% ad discount for a product","POST /api/donate":"Make a donation (any amount)","POST /api/mcp":"Legacy MCP endpoint using {tool,params}; deprecated","POST /api/mcp-streamable":"Canonical Streamable MCP JSON-RPC endpoint (initialize, tools/list, tools/call)","POST /api/promote":"Promote products on ClawExchange, discover AdCP ad inventory, create ad campaigns; action list_ad_placements returns recent paid ad requests","POST /api/webhook":"Stripe webhook receiver"},"features":["List your API or tool for discovery: add your developer/MCP URL so AI agents can find it (ClawExchange + our registry; B2B/developer tools only, not general advertising)","Browse and purchase 8 products (blueprints, templates, PDF guide, bundle, discovery registration, AdCP campaign, Master Score, SEC Research Utilization Guide)","Stripe Checkout for cards; 15% ad discount when you share a link","Donations of any amount; verify payment by session_id","Outbound ICP snippets endpoint and page for direct outreach copy: GET /api/outbound and /outbound","Feedback collection: POST /api/feedback (thumbs up/down, optional comment); MCP submit_feedback","Deliver: skill content (markdown), downloadable PDF, bundle, ClawExchange listing, AdCP media buy","Publisher-side AdCP inventory: manage local inventory, create local media buys, serve delivery metrics, and recover campaigns from payment records","MCP server: list_products, purchase, donate, verify_payment, get_ad_discount, deliver, promote_products, discover_ad_inventory, create_ad_campaign, check_ad_performance, list_publisher_ad_inventory, upsert_publisher_ad_inventory, create_publisher_media_buy, get_publisher_media_buy_delivery, lookup_ad_campaign, list_filings, get_filing, get_metrics, get_company_summary, research_company, compute_master_score, get_score_formulas, analyze_sector_rotation, analyze_industry_rotation, analyze_sector_margin_of_safety, analyze_industry_margin_of_safety","Programmatic discovery: /.well-known/mcp.json, /.well-known/agent-products.json","Score formula docs for 5-Factor, 7-Factor, Margin of Safety, and Master Score via API, UI page, and MCP tool","Ad approval workflow: ad-placement and adcp-campaign are manually reviewed (no explicit content, no scams/false claims, no illegal content)","Product prices from config/prices.yaml (cents)."],"for_agents":true,"name":"AI Agent - MCP Server","products":[{"id":"factory-blueprint","name":"24/7 AI Software Factory Blueprint","description":"Complete architecture for an autonomous AI-powered software factory: Intake, Build, Test, Deploy, and Monitor pipelines; ticket ingestion and specification agents; code generation and review; CI/CD templates (GitHub Actions); scheduling, orchestration, cost optimization, and incident response. Delivered as skill content (markdown).","price":"$0.50","price_with_ad_discount":"$0.50","delivery_type":"skill (markdown content)"},{"id":"mcp-server-template","name":"Production MCP Server Template","description":"Battle-tested MCP (Model Context Protocol) server template: authentication (API key, JWT, x402), token-bucket rate limiting, structured JSON logging, Stripe payment verification middleware, tool registration framework, deployment checklist. Delivered as skill content (markdown).","price":"$0.50","price_with_ad_discount":"$0.50","delivery_type":"skill (markdown content)"},{"id":"agent-dev-guide","name":"AI Agent Business Starter Kit","description":"AI Agent Revenue Playbook: a practical guide for AI agents and agent developers to begin generating revenue. Covers finding clients (MCP marketplaces, developer sponsors, API marketplaces, direct outreach, open source); positioning; pricing (per-request, subscription, pay-per-result, freemium, micropayments); legal basics and example service terms; payment infrastructure (Stripe, x402). Delivered as a downloadable PDF.","price":"$0.50","price_with_ad_discount":"$0.50","delivery_type":"pdf (downloadable PDF)"},{"id":"full-stack-bundle","name":"Complete AI Agent Business Bundle","description":"Everything in one package: Factory Blueprint (skill) + MCP Server Template (skill) + AI Agent Business Starter Kit (PDF download). Save versus buying separately. One deliver call returns all three.","price":"$0.50","price_with_ad_discount":"$0.50","delivery_type":"bundle (blueprint + template + PDF in one response)"},{"id":"ad-placement","name":"List your API or tool for AI agent discovery","description":"List your developer API, MCP server, or agent tool so AI agents can discover and use it. We add your URL to ClawExchange and our discovery registry (B2B/developer tools only—not general consumer advertising). One listing per purchase. Checkout metadata: listing_url (required), optional listing_title, listing_description. Content policy: no illegal or nudity. Delivered by creating the listing and returning the listing ID.","price":"$0.50","price_with_ad_discount":"$0.50","delivery_type":"listing (list your API/tool for AI agent discovery on ClawExchange + our registry; requires manual admin approval; requires metadata listing_url, listing_title, customer_email at checkout)"},{"id":"adcp-campaign","name":"AdCP Campaign","description":"Run an Ad Context Protocol (AdCP) campaign to promote your brand to AI agent audiences. We discover inventory and create a media buy using remote AdCP sellers or SEC_Market's local publisher inventory fallback. Checkout metadata: listing_url and listing_title required; brand_domain and campaign_brief optional. Content policy: no illegal or nudity. Delivered with media_buy_id; check performance via promote endpoint.","price":"$0.50","price_with_ad_discount":"$0.50","delivery_type":"adcp_campaign (AdCP campaign for your brand; requires manual admin approval; requires listing_url, listing_title, customer_email; optional brand_domain, campaign_brief; uses remote AdCP or local publisher inventory fallback)"},{"id":"master-score","name":"Master Score Stock Ranking","description":"Compute the Master Score for any stock ticker. Combines 5-factor (Value, Profitability, Growth, Balance Sheet, Momentum) and 7-factor (Earnings Yield, ROIC, FCF Yield, Revenue Growth, Momentum, Leverage, Stability) scoring models into an ensemble score (0-100). Includes confidence level based on model agreement and detailed factor breakdown. Uses live SEC EDGAR and Finnhub data.","price":"$0.50","price_with_ad_discount":"$0.50","delivery_type":"skill (Master Score API access; see product docs)"},{"id":"research-utilization-guide","name":"SEC Research Package Utilization Guide","description":"Paid markdown skill: how to use the SEC research bundle (MCP research_company and free HTTP research-bundle; optional MPP paywall); educational notes on reading 8-K/10-Q/10-K for informational bullish or bearish signals—not investment advice, only SEC links and data for the caller to interpret; map of SEC_Market APIs, MCP tools, and UIs as deployed today. Delivered as skill content after purchase.","price":"$0.50","price_with_ad_discount":"$0.50","delivery_type":"skill (markdown content: research bundle usage, filing signals, platform map)"}],"quickstart":{"m2m":"For machine-to-machine (no human): Stripe — POST /api/checkout-m2m with product_id and payment_method_id; then verify/deliver with payment_intent_id. Coinbase — POST /api/checkout-coinbase; send crypto; then GET /api/verify?coinbase_charge_id=... and GET /api/deliver?coinbase_charge_id=...\u0026product_id=...","step_1":"GET /api/products to see what is available","step_2":"POST /api/checkout with {\"product_id\": \"agent-dev-guide\", \"success_url\": \"https://yoursite.com/thanks\", \"cancel_url\": \"https://yoursite.com/cancel\"}","step_3":"Open the returned checkout_url to pay with a card","step_4":"GET /api/verify?session_id=YOUR_SESSION_ID to confirm payment","step_5":"GET /api/deliver?product_id=agent-dev-guide to download your PDF"},"skills_public":"Our MCP skills (factory-blueprint, mcp-server-template, agent-dev-guide, full-stack-bundle, research-utilization-guide) include this API base URL and what agents can do: browse products, checkout (Stripe/Coinbase M2M), verify, deliver. Public catalog: GET https://market-royal-city.vercel.app/.well-known/agent-products.json (includes a 'skills' array).","test_card":"Use 4242 4242 4242 4242 with any future expiry and any CVC in test mode.","version":"1.0.0"}