{"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 - Lists your API/tool for AI agent discovery (ClawExchange + our registry; developer tools only). Pass listing_url, optional listing_title/listing_description in checkout metadata. Content policy: no illegal or sexual/nudity.","adcp-campaign":"GET /api/deliver?product_id=adcp-campaign - Runs an AdCP campaign for your brand (requires listing_url and listing_title; optional brand_domain, campaign_brief). Uses remote AdCP or local publisher inventory fallback. Content policy applies.","agent-consultation":"GET /api/deliver?product_id=agent-consultation - Delivers 30-min consultation via private Slack channel (vineyardprod.slack.com)","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 all items (skills + PDF link + consultation Slack invite)","mcp-server-template":"GET /api/deliver?product_id=mcp-server-template - Returns skill content 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/company/us/score-formulas":"Score formula definitions (5-Factor, 7-Factor, MoS, Master Score) for API and agent consumption","GET  /api/deliver":"Deliver purchased product (session_id, payment_intent_id, or coinbase_charge_id + product_id)","GET  /api/health":"Health check","GET  /api/mcp":"MCP Server manifest (tool listing for AI agents)","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/verify":"Verify payment (session_id, payment_intent_id, or coinbase_charge_id)","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/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/discount":"Preview the 15% ad discount for a product","POST /api/donate":"Make a donation (any amount)","POST /api/mcp":"Execute an MCP tool","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 7 products (blueprints, templates, PDF guide, consultation, bundle, discovery registration, AdCP campaign)","Stripe Checkout for cards; 15% ad discount when you share a link","Donations of any amount; verify payment by session_id","Deliver: skill content (markdown), downloadable PDF, consultation via Slack channel, 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, lookup_ad_campaign, list_ad_placements, analyze_sector_rotation","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 content policy: no illegal or nudity; track and share ad placements via GET /api/ad-placements","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":"agent-consultation","name":"1-on-1 AI Agent Setup Consultation","description":"30-minute live consulting session: architecture review, payment-flow and MCP endpoint guidance, written recommendations, 7-day follow-up. Delivered via private Slack channel invite (vineyardprod.slack.com). You are paying for the consultation service, not Slack access.","price":"$0.50","price_with_ad_discount":"$0.50","delivery_type":"consultation (30-min session delivered via private Slack channel; vineyardprod.slack.com)"},{"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) + 1-on-1 Consultation (Slack invite). Save versus buying separately. One deliver call returns all items.","price":"$0.50","price_with_ad_discount":"$0.50","delivery_type":"bundle (all of the above)"},{"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; B2B/developer tools only; requires metadata listing_url 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 listing_url and listing_title; 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":""}],"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, agent-consultation, full-stack-bundle) 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"}