Placement API MCP server

Q: How do I add Placement API MCP to Claude Code?

Run `claude mcp add --transport http placementapi https://api.placementapi.com/mcp` in your terminal. Add `--scope user` to make it available in every project.

Q: How do I add Placement API MCP to Cursor?

Open `~/.cursor/mcp.json` and add the server under `mcpServers`, using the Cursor config shown in the install section above.

Commit Sep 7, 2026

futurebets/placementapi · typescript · MIT

Allows an AI client to search, plan, and purchase SEO link placements across multiple marketplaces using a single interface.

Also known as futurebets/placementapi, placementapi

remote 4 tools Workflow Automation

Install GitHub ↗

Stars: 0
Tools: 4
Downloads, 30 days: —
Latest version: 1.0.0
Last commit: Sep 7, 2026
License: MIT

What is Placement API MCP?

Placement API allows an AI client to search, plan, and purchase SEO link placements across multiple marketplaces using a single interface. It exposes 4 tools, such as search_placements, plan_links, compare_domain.

Summary generated from the project's README

About Placement API MCP server

Placement API provides a unified interface for searching, planning, and purchasing SEO link placements across numerous marketplaces. It is designed for developers and AI agents who need to manage backlink strategies through a single connection. Users can connect via a streamable HTTP transport using a Bearer API key, making it compatible with Claude Code, Cursor, Windsurf, and custom connectors in Claude.ai or ChatGPT.

The server includes specialized tools for different stages of the SEO workflow. Developers can use search_placements to browse approximately 550,000 priced placements or plan_links to generate costed strategies based on specific budgets and domain authority requirements. The system uses a credit-based payment model where prices are held for four hours. Depending on the API key permissions, users can either perform read-only tasks like comparing domains or execute orders and submit content using place_order and submit_content.

What you can do with it

1Execute SEO link strategiesAn AI agent can generate a costed plan of specific domains based on a provided budget and topic.
2Analyze competitor backlink profilesA developer can identify which sites competitors are buying to replicate their link building success.
3Verify domain authority qualityUsers can check if a publisher's authority is legitimate or if it shows signs of being a link farm.
4Automate content and placementThe system allows for ordering links and either providing the article or having the service write it.

Written from the project's README. Every use case is checked against a quote from it.

How to install Placement API MCP

Formats verified 10 Nov 2026Add to Cursor Add to Goose

Claude CodeCursorVS CodeVS Code CLICodexCodex config.tomlGemini CLIGemini settings.json

$ claude mcp add --transport http placementapi https://api.placementapi.com/mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "placementapi": {
      "url": "https://api.placementapi.com/mcp"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "placementapi": {
      "type": "http",
      "url": "https://api.placementapi.com/mcp"
    }
  }
}

$ code --add-mcp '{"name":"placementapi","type":"http","url":"https://api.placementapi.com/mcp"}'

$ codex mcp add placementapi --url https://api.placementapi.com/mcp

~/.codex/config.toml

[mcp_servers.placementapi]
url = "https://api.placementapi.com/mcp"

$ gemini mcp add -s user --transport http placementapi https://api.placementapi.com/mcp

~/.gemini/settings.json

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

No environment variables or API keys required.Setup guides:Claude Code Cursor VS Code Claude Desktop

Placement API MCP tools 4

Detected from the README

search_placements
plan_links
compare_domain
keyword_winners

search_placements	—
plan_links	—
compare_domain	—
keyword_winners	—

Automated checks

Ran Nov 15, 2026Full report →

75/100

Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points

Show this score in your README

Source repository linked and reachablefuturebets/placementapi is public and reachablegithub.com/futurebets/placementapi ↗Pass
Package names this repository as its sourceNot checked
Build provenance (Sigstore attestation)Not checked
Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
Commit or release in the last yearLast commit or release 2026-09-07github.com/futurebets/placementapi ↗Pass
OpenSSF ScorecardNot checked
Package name not close to a popular packageNot checked
No critical advisory in the package or its dependenciesNot checked
No hidden instructions to the model4 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
Destructive tools are labelledNo tool named like delete, drop or execPass
Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 343 msPass

README

View on GitHub

Placement API

Buy SEO link placements across every marketplace from one API or MCP server. Named, inspectable domains with live prices, independent verification, a survival record for every publisher we have bought from, and one invoice — paid with prepaid credits.

Website: https://placementapi.com · For agents: https://placementapi.com/agents · API reference: https://placementapi.com/api
MCP endpoint: https://api.placementapi.com/mcp (streamable HTTP, Bearer API key)
OpenAPI: https://api.placementapi.com/openapi.json · Field semantics: https://api.placementapi.com/v1/schema
Live market data: https://placementapi.com/data · Prices by type, DR and topic: https://placementapi.com/pricing

This repository holds the TypeScript client (sdk/, published to npm as placementapi) and the MCP registry manifest (server.json). The service itself is not open source.

Connect the MCP server

# Claude Code
claude mcp add --transport http placement-api https://api.placementapi.com/mcp \
  --header "Authorization: Bearer $PLACEMENT_KEY"

// Cursor / Windsurf / any host that takes a JSON config
{ "mcpServers": { "placement_api": { "url": "https://api.placementapi.com/mcp",
  "headers": { "Authorization": "Bearer pk_live_…" } } } }

Claude.ai / ChatGPT: Settings → Connectors → add custom connector with the URL above and the Authorization header.

Get a key at https://app.placementapi.com/dashboard. A read key can search, plan and compare; an order key can spend credits.

Tools

Tool	What it does
`search_placements`	Search ~550k priced placements deduplicated by domain, with verification, score and price plausibility on every row
`plan_links`	A brief in (links, topic, DR, budget, strategy) → a costed plan of named domains, each with `why`, held at price for four hours
`compare_domain`	Everything about one publisher: listings and spread, verification, web-graph, survival, outcomes, Placement Score, market reference
`target_profile` / `gap_map`	Your page's backlink profile and the competitor links you can reproducibly buy, priced
`keyword_winners`	What the sites that rank for a keyword look like, and what they buy
`place_order` · `submit_content` · `write_it_for_me`	Order at the held price; supply the article, let the publisher write it, or have it written
`list_orders` · `campaign_status` · `order_outcome`	Fulfilment, live checks and observed rank movement (observed, never attributed)
`standing_orders` · `create_standing_order`	Recurring plans; auto-placement can only be enabled from the dashboard
`check_balance` · `cancel_order`

Use the SDK

npm i placementapi

import { PlacementApi } from "placementapi";

const api = new PlacementApi({ apiKey: process.env.PLACEMENT_KEY! });
const quote = await api.quote({ links: 5, topic: "finance", dr_min: 50, strategy: "safest" });
for (const l of quote.lines) console.log(l.domain, l.price_credits, l.verification, l.why.join(" · "));

See sdk/README.md.

Things worth knowing

Credits are US cents. Prices on a quote are held for four hours; order with the quote_id to pay the held price.
verification says whether a domain's authority is real: ok, suspect (high link authority with no organic footprint — what a link farm looks like) or unverified. quality_reasons names which of five tests fired. Method: https://placementapi.com/research/quality-methodology
Suppliers are never identified. You see counts and spreads, never who. That is a product rule, not a gap.
why[] on every line is the factual basis for the pick, in sentences an agent can repeat.

Support: hello@placementapi.com · Terms: https://placementapi.com/terms

Read full README

Placement API MCP questions

How do I add Placement API MCP to Claude Code?

Run claude mcp add --transport http placementapi https://api.placementapi.com/mcp in your terminal. Add --scope user to make it available in every project.

How do I add Placement API MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

What tools does Placement API MCP provide?

It exposes 4 tools, including search_placements, plan_links, compare_domain, keyword_winners.

What is the difference between a read key and an order key?

A read key allows you to search, plan, and compare placements, while an order key enables you to spend credits to make purchases.

How long are the prices held for?

Prices provided in a quote are held for four hours.

About Placement API MCP server

What you can do with it

1Execute SEO link strategiesAn AI agent can generate a costed plan of specific domains based on a provided budget and topic.
2Analyze competitor backlink profilesA developer can identify which sites competitors are buying to replicate their link building success.
3Verify domain authority qualityUsers can check if a publisher's authority is legitimate or if it shows signs of being a link farm.
4Automate content and placementThe system allows for ordering links and either providing the article or having the service write it.

Written from the project's README. Every use case is checked against a quote from it.

Tool

What it does

search_placements

Search ~550k priced placements deduplicated by domain, with verification, score and price plausibility on every row

plan_links

A brief in (links, topic, DR, budget, strategy) → a costed plan of named domains, each with why, held at price for four hours

compare_domain

Everything about one publisher: listings and spread, verification, web-graph, survival, outcomes, Placement Score, market reference

target_profile / gap_map

Your page's backlink profile and the competitor links you can reproducibly buy, priced

keyword_winners

What the sites that rank for a keyword look like, and what they buy

place_order · submit_content · write_it_for_me

Order at the held price; supply the article, let the publisher write it, or have it written

list_orders · campaign_status · order_outcome

Fulfilment, live checks and observed rank movement (observed, never attributed)

standing_orders · create_standing_order

Recurring plans; auto-placement can only be enabled from the dashboard

check_balance · cancel_order

import { PlacementApi } from "placementapi"; const api = new PlacementApi({ apiKey: process.env.PLACEMENT_KEY! }); const quote = await api.quote({ links: 5, topic: "finance", dr_min: 50, strategy: "safest" }); for (const l of quote.lines) console.log(l.domain, l.price_credits, l.verification, l.why.join(" · "));

Placement API MCP questions

How do I add Placement API MCP to Claude Code?

Run claude mcp add --transport http placementapi https://api.placementapi.com/mcp in your terminal. Add --scope user to make it available in every project.

How do I add Placement API MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

What tools does Placement API MCP provide?

It exposes 4 tools, including search_placements, plan_links, compare_domain, keyword_winners.

What is the difference between a read key and an order key?

A read key allows you to search, plan, and compare placements, while an order key enables you to spend credits to make purchases.

How long are the prices held for?

Prices provided in a quote are held for four hours.

Placement API MCP server

What is Placement API MCP?

About Placement API MCP server

What you can do with it

How to install Placement API MCP

Install Placement API MCP in Claude Code

Install Placement API MCP in Cursor

Install Placement API MCP in VS Code

Install Placement API MCP in VS Code CLI

Install Placement API MCP in Codex

Install Placement API MCP in Codex config.toml

Install Placement API MCP in Gemini CLI

Install Placement API MCP in Gemini settings.json

Placement API MCP tools 4

Automated checks

README

Placement API

Connect the MCP server

Tools

Use the SDK

Things worth knowing

Placement API MCP questions

Placement API MCP server

What is Placement API MCP?

About Placement API MCP server

What you can do with it

How to install Placement API MCP

Install Placement API MCP in Claude Code

Install Placement API MCP in Cursor

Install Placement API MCP in VS Code

Install Placement API MCP in VS Code CLI

Install Placement API MCP in Codex

Install Placement API MCP in Codex config.toml

Install Placement API MCP in Gemini CLI

Install Placement API MCP in Gemini settings.json

Placement API MCP tools 4

Automated checks

README

Placement API

Connect the MCP server

Tools

Use the SDK

Things worth knowing

Placement API MCP questions