Spillmark icon

Spillmark public MCP reference

A read-only Model Context Protocol server for Amazon seller math

This page is a public reference for the Spillmark MCP. The official product and agent documentation live on https://spillmark.com and https://spillmark.com/agents. The listing repository is https://github.com/burmanharry/spillmark-mcp.

Endpoint

Server URL: https://spillmark.com/mcp

Transport: Streamable HTTP. Call the URL with HTTP POST and a JSON-RPC body. A GET to the same path redirects to the official docs at /agents, so clients should POST.

Suggested headers:

Content-Type: application/json
Accept: application/json, text/event-stream

The same public tools are also exposed over REST at https://spillmark.com/api/v1, which lists each tool and its input schema. Public tools need no key. Brand tools, documented on the official agents page, use Authorization: Bearer sm_... and are also read-only.

On November 20, 2026 a live initialize call returned server name spillmark, version 0.1.0, and the website https://spillmark.com. The official agents page was last updated November 6, 2026.

Public tools (no key)

A live tools/list call on November 20, 2026 returned three read-only tools. That matches the official docs.

Tool What it does
list_calculators Lists Spillmark's free Amazon and Meta ads calculators, with each one's slug, summary, inputs, and example values. Optional input: q, a short word filter such as holdout or fees. Use run_calculator to run one. On the date above, the unfiltered list contained 27 calculators.
run_calculator Runs one calculator from that list. Required: slug. Optional: inputs (values by key) and currency (USD, EUR, GBP, CAD, or AUD; default USD). Missing inputs use the calculator's example values. Enter percents as points (15 means 15%). Choices use the option index. The response includes a headline result, supporting figures, a one-sentence reading, and a link that opens the same calculator with those inputs.
how_lift_is_calculated A brief of Spillmark's geo holdout method: how a test measures the Amazon sales Meta ads cause, with a link to the full method and a sample report on made-up numbers. No inputs.

The calculators themselves also have web pages under https://spillmark.com/tools. Calculator results are planning math on the numbers you provide. They are not a brand's measured holdout result. The full method is at https://spillmark.com/how-lift-is-calculated.

Example calls

These examples were run against the live server on November 20, 2026. They are copy-paste starting points, not a software development kit.

Initialize, then list tools

curl -sS -X POST https://spillmark.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"docs-example","version":"1.0"}}}'

curl -sS -X POST https://spillmark.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

Read the lift method

curl -sS -X POST https://spillmark.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"how_lift_is_calculated","arguments":{}}}'

The REST mirror of that tool is a GET:

curl -sS https://spillmark.com/api/v1/how_lift_is_calculated

The tool returns a five-step summary, the method URL, and a sample report labeled as made-up numbers. In that sample, lift is 0.18 with a 95% range from 0.05 to 0.32. Do not treat the sample as a measured brand result.

List calculators, then run one

curl -sS -X POST https://spillmark.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"list_calculators","arguments":{}}}'

curl -sS -X POST https://spillmark.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":5,"method":"tools/call","params":{"name":"run_calculator","arguments":{"slug":"holdout-test-calculator","currency":"USD"}}}'

REST equivalent:

curl -sS -X POST https://spillmark.com/api/v1/run_calculator \
  -H "Content-Type: application/json" \
  -d '{"slug":"holdout-test-calculator","currency":"USD"}'

Called with no custom inputs on November 20, 2026, holdout-test-calculator used its example values (including weekly sales per region of 1,500, 20 regions, 6 weeks, and a 20% lift) and returned a minimum detectable lift of 17.9%, with a link back to the calculator on spillmark.com that already had those inputs filled in. If you pass your own inputs, the result will differ.

Connect a client

For public tools, no authorization header is required.

Cursor (.cursor/mcp.json or .mcp.json)

{
  "mcpServers": {
    "spillmark": {
      "url": "https://spillmark.com/mcp"
    }
  }
}

Claude Code

claude mcp add --transport http spillmark https://spillmark.com/mcp

Claude or ChatGPT

Add a custom connector or MCP server with URL https://spillmark.com/mcp. Listed directory apps are not available yet, as stated on the official agents page.

Brand tools are optional and need a key created in Spillmark Settings, then Agent access. Those tools read one brand's profit and incrementality record. They do not change ads, budgets, orders, or settings. See https://spillmark.com/agents for the brand-tool list. Amazon Ads API write tools are on the roadmap.

Limits and honesty rules

What Spillmark is

Spillmark is software for running an Amazon seller business with AI: monitoring, alerts, and actions the seller approves. The homepage headline is "Run Amazon on Autopilot." It is operated by Cantein, LLC, in Monterey, California. Questions: hello@spillmark.com.