# Placement.sh [Health: Active]

**Category:** 🎯 Marketing  
**Repository:** https://placement.sh/  
**Views:** 2  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/placement-sh

## Description
MCP skill that finds free directories, marketplaces, and review platforms where your site can get listed, then preps the submission form. Bought placements available at fixed prices once free options run out.

## Tools
Capabilities this server exposes over MCP:

- **start** — Call this on the first human message after connect. Returns the exact first-turn script: who runs this (Shortlist), what we sell, and what to ask. Do not skip this.
- **help** — When to use placement.sh, the playbook, and a worked example. Call start on connect. Call help if you are unsure.
- **estimate** — Paid-path tool — call this when the human wants to buy. Sketch what a budget buys at exact listed prices (no packs). Placement counts across Placement Score bands. No commitment, no reserved inventory, no card to look.
- **search_publishers** — Browse paid placement.sh inventory. Looking is unlimited and needs no account — use this to figure out what the human could write about. Returns anonymized publisher handles; domains are revealed only when a placement is delivered. Page with limit/offset. Prefer estimate once they have a budget; book only after they are ready to pay.
- **get_publisher** — Full anonymized profile for one publisher handle: Placement Score, pricing tiers, content summary, what it writes about, posting constraints, explicit link_attribute.
- **inventory_stats** — Aggregate view of paid placement.sh inventory: counts by niche and Placement Score band. No publisher identities.
- **register_account** — Save who the human is. Ask them for a contact email after analyze_site has read their site — do not invent one. Signup takes no card. We email a 6-digit code; call confirm_email after they read it. Looking stays open. Buying waits. Pass the key as "Authorization: Bearer <key>" on later calls.
- **confirm_email** — Confirm the human owns the inbox. They read a 6-digit code we emailed (or clicked the link). Ask them for the code — do not invent one. Looking works before this. Buying does not.
- **account_status** — Account state: registered or not, whether the inbox is confirmed, prepaid credit balance, and the next step. Looking is unlimited without an account. Registration is not payment. Buying waits for confirm_email.
- **add_credits** — Create a Stripe Checkout link for the exact USD amount being bought (the publisher listed_price, or the campaign budget). No packs yet. Requires a registered account whose inbox is confirmed (confirm_email). Show Shortlist (shortlist.io / about-us / 15-min Calendly call) before they pay. After they pay, call account_status. Never invent a payment URL.
- **create_campaign** — Start a paid booking: target URL, topics, budget, optional publisher_id. Requires a confirmed inbox (confirm_email) and prepaid credits equal to the amount being bought. If credits are short, follow next_step and show checkout_url — never invent a payment URL.
- **get_writing_brief** — How to write the guest post for a paid publisher handle. Pass company_id from analyze_site (one per client site) and target_url so the brief includes that company and a page extract. Domain stays hidden.
- **submit_placement** — Submit the finished post (title + body) for a publisher handle. Holds listed_price from prepaid credits. Shortlist processes it on the backend. Requires a confirmed inbox + credits. Never invent a publisher domain.
- **get_order** — One submitted placement: its state, the published_url once it is live (the first time the publisher is named), the T+30 link check, and whether the price is held, charged or refunded.
- **list_orders** — Every placement on this account, newest first. Agencies: pass company_id for one client. format "csv" returns a client-ready report (live URL, Ahrefs DR, T+30 result) with no publisher domain except the live URL itself.
- **cancel_order** — Cancel a placement while Shortlist is still reviewing it (state human_review). The price goes back to credits. Once it has been sent to the publisher it cannot be cancelled.
- **analyze_site** — Read the company URL being placed and build the profile matching and writing use. Returns a company_id (this one site) and a workspace_key (the agency bag). Pass workspace_key when analysing another client so they stay together. If the derived topics look generic, call again with topics you wrote from the page.
- **list_companies** — Every company in this workspace. Agencies: one workspace_key, one company_id per client site. Pass workspace_key from analyze_site, or call with the account Bearer key after register_account. Then pass the right company_id to estimate, search_publishers, get_writing_brief, submit_placement and list_orders. Never reuse client A’s id on client B.

## Claude Desktop Quick Installation
No confirmed install details yet, so no config is published. Follow the setup steps in the repository above.

## Documentation

## What the Placement.sh MCP server does

The Placement.sh MCP server helps identify places where a website can be submitted for exposure. Its scope includes free directories, marketplaces, and review platforms. Rather than limiting discovery to one type of listing site, it searches across these three categories for possible placements.

The service also prepares the submission form for a discovered opportunity. That makes the next step more structured: an agent can find a relevant destination and produce the form needed for a site submission.

## How it works

The Placement.sh MCP server starts with free opportunities. It looks for directories, marketplaces, and review platforms where the user’s site may be listed, then prepares the associated submission form. This creates a discovery-and-preparation flow rather than a general marketing automation system.

When free options have been used or are no longer available, the service can expose bought placements. These placements are offered at fixed prices.

## Tools and capabilities

- Find free directories suitable for site listings.
- Find marketplaces where a site may be submitted.
- Find review platforms that accept site listings or reviews.
- Prepare a submission form for a discovered placement.
- Present bought placements at fixed prices after free options run out.

The available source describes these capabilities at a product level but does not provide individual MCP tool names, input schemas, output schemas, or examples. Developers should verify those details from the live service before implementing an agent workflow around them.

## Limitations and notes

Placement.sh is focused on finding placement opportunities and preparing their submission forms.

No README is available in the supplied source, so installation commands, transport details, authentication requirements, environment variables, supported MCP clients, and licensing information cannot be established here. The source also does not explain how a site is provided to the service or how results are filtered.

The paid-placement option should be treated separately from the free search flow. Fixed pricing is stated, but the material does not document purchasing steps, billing, refunds, placement duration, or acceptance criteria. Use the free discovery and form-preparation capabilities when the goal is to identify potential listing destinations without assuming that Placement.sh completes the submission process.

_Full upstream README: https://allmcps.com/mcp/placement-sh/readme_