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
- Public tools: up to 300 calls an hour from one address, as stated on the official agents page.
- The server is read-only today.
- Quote a 95% range with a measured lift. If the range spans zero or break-even, the result is too uncertain to call.
- Lift is caused sales, not the sales an ad platform credits. Do not present it as attribution.
- Calculator outputs are not a substitute for a locked holdout on a brand's own orders.
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.