MCP Server

Sponsoric exposes its full ad platform as MCP (Model Context Protocol) tools, so AI agents like Claude can create campaigns, sign up as publishers, and manage ads through natural conversation.

Quick Start

Point your MCP client at our hosted endpoint — no install required:

https://sponsoric.com/api/mcp

For Claude Code, add to your project's .claude/settings.json:

{
  "mcpServers": {
    "sponsoric": {
      "type": "url",
      "url": "https://sponsoric.com/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_your_api_key_here"
      }
    }
  }
}

For other MCP clients that support HTTP transport, send JSON-RPC requests to POST https://sponsoric.com/api/mcp.

Authentication

Some tools (earnings, payouts, ad management) require your API key. Pass it via the Authorization header in your MCP server config:

{
  "headers": {
    "Authorization": "Bearer sk_your_api_key_here"
  }
}

Your API key (sk_...) is returned when you sign up as a publisher or create your first campaign. You can also:

• View it in your dashboard settings
• Regenerate it via the sponsoric_regenerate_api_key tool
• Recover it via email: POST https://sponsoric.com/api/auth/api-key with { "email": "you@example.com" }

Self-hosted MCP: If you're running the Sponsoric MCP server locally (not using our hosted endpoint), set the SPONSORIC_API_KEY environment variable instead.

Available Tools

sponsoric_analyze_product

Input: { url: "https://yourproduct.com" }

sponsoric_create_campaign

1. First call (without txHash): Returns payment details — USDC amount and Tempo wallet address.
2. Second call (with txHash): After sending USDC on the Tempo blockchain, call again with the transaction hash to verify payment and activate the campaign.

{
  "email": "you@company.com",
  "name": "Your Product",
  "url": "https://yourproduct.com",
  "headline": "AI-generated or custom headline",
  "body": "Ad body copy",
  "ctaText": "Try Free",
  "tags": ["developer-tools", "saas"],
  "budgetCents": 5000,
  "startsAt": "2026-04-01",
  "endsAt": "2026-04-30",
  "txHash": "0x... (include on second call)",
  "promoCode": "LAUNCH2026 (optional, for bonus credits)"
}

If a bonus tier is unlocked, the response includes bonusCents and totalBudgetCents.

sponsoric_analyze_site

Input: { url: "https://myblog.dev" }

sponsoric_publisher_signup

Input:

{
  "email": "you@site.com",
  "siteName": "My Dev Blog",
  "siteUrl": "https://myblog.dev",
  "tags": ["developer-tools", "productivity"],
  "tempoWalletAddress": "0x... (optional, for automatic USDC payouts — save your private key too)"
}

sponsoric_add_funds

Input: { adId: "your-product-abc123", amountCents: 5000, txHash: "0x... (second call)", promoCode: "LAUNCH2026 (optional)" }

sponsoric_bonus_tiers

Input: { "code": "LAUNCH2026 (optional)", "budgetCents": 10000 }

Example response:

{
  "promoCode": null,
  "tiers": [
    { "threshold": "$50", "bonus": "+$5", "totalBudget": "$55", "unlocked": true },
    { "threshold": "$100", "bonus": "+$15", "totalBudget": "$115", "unlocked": true },
    { "threshold": "$250", "bonus": "+$45", "totalBudget": "$295", "unlocked": false },
    { "threshold": "$500", "bonus": "+$100", "totalBudget": "$600", "unlocked": false }
  ],
  "yourBudget": "$100.00",
  "currentBonus": "+$15",
  "totalWithBonus": "$115.00",
  "nextTier": {
    "threshold": "$250",
    "bonus": "+$45",
    "spendMore": "$150.00"
  }
}

sponsoric_check_earnings

sponsoric_request_payout

sponsoric_manage_ad

Input:

{
  "action": "pause-ad",
  "id": "your-ad-id"
}

For create-ad, include headline, body, ctaText, ctaUrl, tags, and optionally budgetCents, fundedVia ("stripe" or "tempo", defaults to the advertiser's most recent ad's source), advertiserId, startsAt, endsAt.

sponsoric_check_campaigns

sponsoric_update_settings

Input: { "tempoWalletAddress": "0x..." } — pass empty string to clear. Make sure you have the private key for any wallet address you set — without it, you cannot access your payouts.

sponsoric_connect_stripe

Input: { "publisherId": "optional — defaults to your first publisher" }

Returns { onboardingUrl: "https://connect.stripe.com/..." } if not yet connected, or a confirmation if already set up.

sponsoric_regenerate_api_key

sponsoric_get_docs

Input: { page: "api-reference" } or {} for the index.

Available pages: getting-started-advertiser, getting-started-publisher, api-reference, payouts, content-policy, fraud-prevention, mcp

Full Example: Agent Runs an Ad Campaign

Here's what the conversation looks like when an agent uses these tools:

Human: "Advertise my product at myapp.dev on Sponsoric with a $50 budget"
Agent: [calls sponsoric_analyze_product with url "https://myapp.dev"]
→ Gets: name, headline, body, tags, safety score
Agent: [calls sponsoric_create_campaign with analyzed data + budgetCents: 5000]
→ Gets: 402 payment details — send $50 USDC to 0x7f6F... on Tempo
Agent: [sends USDC to recipient on Tempo using viem, ethers, or any wallet SDK]
→ Gets: txHash "0xabc..."
Agent: [calls sponsoric_create_campaign again with txHash]
→ Gets: { advertiserId: "myapp", adId: "myapp-abc123", status: "live" }
Agent: "Your ad is live! It's running across Sponsoric's network of developer
and creator sites. You can track performance at sponsoric.com/dashboard"

Full Example: Agent Becomes a Publisher

Human: "Add Sponsoric ads to myblog.dev"
Agent: [calls sponsoric_analyze_site with url "https://myblog.dev"]
→ Gets: siteName, description, tags
Agent: [calls sponsoric_publisher_signup with data + email]
→ Gets: { publisherId: "myblog", embedCode: "<script>..." }
Agent: "Done! Add this embed code to your site:
<script async src='https://sponsoric.com/api/ads/embed' data-site='myblog'></script>
You'll earn 70% of every ad click."

Prompt for Your Agent

Copy this prompt to give your agent the context it needs:

You have access to Sponsoric MCP tools for advertising on tech sites. To create an ad campaign: first analyze the product URL with sponsoric_analyze_product, then create the campaign with sponsoric_create_campaign. The first call returns USDC payment details on the Tempo blockchain. After the user pays, call sponsoric_create_campaign again with the transaction hash to go live. To become a publisher, use sponsoric_analyze_site then sponsoric_publisher_signup. Use sponsoric_get_docs if you need more details.