Skip to content

SparkAds

by sparkads.dev · remote · no sign-in to list tools · v1.0.0 · published by dev.sparkads

Manage your SparkAds slot: your stats, the free-hour grid, network totals, and your own creative.

Changes · 1

5 tools: 1 change things and 4 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http sparkads https://sparkads.dev/api/mcp/mcp

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

5 tools

Changes things 1Claude Code: ask
  • update_creativeEdit this advertiser's ad card.No findings

    Why it is in this group

    • The name "update_creative" says "update": a word for a change.
    Description, as the server wrote it
    Edit this advertiser's ad card. Pass only the fields to change; anything omitted keeps its current value. WRITE TOOL, and it costs something: saving resets the card's status to 'pending', so the ad STOPS running until a person approves it again. Say that to the user and get their agreement before calling this. Caps: name 40 characters, tagline 60, one-sentence body 160, url must be https, domain must be a bare hostname like myapp.com. House style: plain words, no exclamation marks, and the sentence says what the product does rather than why it is good.
Only reads 4Claude Code: allow
  • get_my_statsGet this advertiser's own ad performance for the last 30 days: impressions and clicks split by day, by app in the Spark network, and by traffic source, plus every creative they own…No findings

    Why it is in this group

    • The name "get_my_stats" says "get": a word for reading.
    Description, as the server wrote it
    Get this advertiser's own ad performance for the last 30 days: impressions and clicks split by day, by app in the Spark network, and by traffic source, plus every creative they own with its review status. Read-only. Scoped to the API key holder; it cannot report on anyone else.
  • get_network_pulseGet the whole network's last 24 hours: total impressions, total clicks, how many apps showed the carousel, and how many of the 24 hourly slots are taken.No findings

    Why it is in this group

    • The name "get_network_pulse" says "get": a word for reading.
    Description, as the server wrote it
    Get the whole network's last 24 hours: total impressions, total clicks, how many apps showed the carousel, and how many of the 24 hourly slots are taken. This is the public inventory figure, the same one the SparkAds landing page prints, not this advertiser's own numbers. Read-only.
  • get_slotGet the hour this advertiser holds: the UTC hour, the same hour on their target country's clock, the country itself, and the card that runs in it with its review status.No findings

    Why it is in this group

    • The name "get_slot" says "get": a word for reading.
    Description, as the server wrote it
    Get the hour this advertiser holds: the UTC hour, the same hour on their target country's clock, the country itself, and the card that runs in it with its review status. Also reports whether the ad is actually live right now, which needs all three of a held hour, an approved card and a paying subscription. Read-only.
  • list_free_slotsList the UTC hours nobody has claimed yet, out of the 24 the network sells.No findings

    Why it is in this group

    • The name "list_free_slots" says "list": a word for reading.
    Description, as the server wrote it
    List the UTC hours nobody has claimed yet, out of the 24 the network sells. Pass a country to also get each free hour on that country's clock and the best five ranked by local evening attention. Supported countries: GB, IE, PT, FR, DE, ES, IT, NL, BE, SE, NO, DK, PL, CH, AT, NG, FI, GR, RO, UA, EG, ZA, IL, SA, TR, RU, KE, AE, PK, IN, BD, TH, VN, ID, CN, SG, MY, PH, HK, TW, AU, JP, KR, NZ, BR, AR, US, CA, PE, CO, MX. Read-only; claiming an hour still happens on the website.

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.0.0. Values in angle brackets are yours to fill in.

claude mcp add --transport http sparkads https://sparkads.dev/api/mcp/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__sparkads__get_my_stats",
      "mcp__sparkads__get_slot",
      "mcp__sparkads__list_free_slots",
      "mcp__sparkads__get_network_pulse"
    ],
    "ask": [
      "mcp__sparkads__update_creative"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as sparkads. Review it before you use it.