SparkAds

dev.sparkadsPublished by sparkads.devOfficial publisherv1.0.0Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Remote SparkAds MCP server that lets an assistant read an advertiser's ad stats, check held and free hourly slots, and edit their ad card.

What you can do
  • Read the advertiser's own 30-day ad performance: impressions and clicks by day, by app and by traffic source, plus owned creatives and their review status.
  • Check the held hourly slot: UTC hour, the same hour in the target country, the country, the running card and whether the ad is live now.
  • List unclaimed hours out of the 24 the network sells, optionally with local-clock times and the top five ranked by local evening attention.
  • Read network-wide public totals for the last 24 hours: impressions, clicks, apps showing the carousel and taken slots.
  • Edit the advertiser's ad card, changing only the fields supplied.
When to use it
Useful when an advertiser on the SparkAds network wants an assistant to review their campaign performance, see which hourly slots are still free, or adjust their ad card without opening the dashboard.
Requirements
A remote streamable HTTP endpoint at sparkads.dev; no packages, environment variables or headers are declared. Access is scoped to the API key holder, so an advertiser account and its key are implied.
Before you install
The creative update tool writes and has a cost: saving resets the card to pending, so the ad stops running until a person approves it again; confirm with the user first. Stats are limited to the key holder's own account. Network pulse figures are public inventory totals, not the advertiser's own numbers.

Installation

In SourceWeft

  1. Open SparkAds in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/dev.sparkads%2Fsparkads/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "sparkads": {
      "type": "http",
      "url": "https://sparkads.dev/api/mcp/mcp"
    }
  }
}

Tools

5

get_my_stats

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.

Takes no parameters.

get_slot

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.

Takes no parameters.

list_free_slots

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.

Parameterscountry

get_network_pulse

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.

Takes no parameters.

update_creative

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.

Parametersurlbodynamedomaintagline

Version history

1
  1. v1.0.0LatestSep 18, 2026

Score

83% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.