Placements MCP server

Essentras MCP server

Buy press coverage from an AI agent.

Essentras is a marketplace for paid media placements. This MCP server makes the catalogue machine readable end to end: an agent can search 3,800+ vetted outlets by budget, domain authority, geography, topic and link policy, price a basket, and hand the buyer a checkout link. No account, no API key, nothing to negotiate.

Listed in the official MCP Registry as com.essentras/placements.

Quick start

Add this to any MCP client (Claude Desktop, Claude Code, Cursor, VS Code):

{
  "mcpServers": {
    "essentras": {
      "type": "http",
      "url": "https://essentras.com/api/mcp"
    }
  }
}

Then ask for what you want:

Find US tech outlets under $400 that give dofollow links, then price the best three.

I have $2,000 for fintech press in the UK. What can I get?

What does a placement on Business Insider cost, and how long does it take?

Tools

All three are annotated read-only and idempotent.

The agent never pays

This is a design decision, not a limitation waiting to be removed.

The server holds no payment method and cannot take money. quoteplacements returns a checkouturl; the buyer opens it, sees the same basket at the same total, and pays on essentras.com. So the worst case for someone who hands an agent too much trust is a basket they did not want, never a charge they did not authorize.

A capability the server does not have is a stronger guarantee than an instruction a model might ignore.

The quote is the price

quote_placements exists rather than expecting you to add up list prices, because the basket total is not the sum of its parts: volume tiers apply at 3 and 5 placements. The page, the REST API, the MCP server and the charge all read one pricing function, so the number an agent reports is the number the buyer is charged.

Billing is at checkout, not on publication. If the placement does not publish, or the stated turnaround is missed, the order is refunded.

Plain HTTP

Everything the MCP server does is also a REST endpoint, described by OpenAPI 3.1.

curl "https://essentras.com/api/agent/v1/outlets?country=US&dofollow=true&max_price=400&limit=3"

curl -X POST https://essentras.com/api/agent/v1/quote \
  -H 'Content-Type: application/json' \
  -d '{"items":[{"id":"business-insider"},{"id":"msn"}]}'

See examples/quickstart.sh for a runnable walkthrough.

Protocol support

Streamable HTTP, dual era on purpose. The server implements the 2026-07-28 revision (stateless, server/discover, per-request meta, resultType, cache hints) and** the earlier initialize handshake, because a large share of clients in the wild still open the old way. Unsupported versions get a proper UnsupportedProtocolVersionError with the list of versions we do speak, so a client can retry rather than guess.

Limits and honest notes

Shortened. The full README is on GitHub.