---
name: submit-site
description: Submit a website to the LinkSwap bot-native directory, publish the reciprocal badge, verify it to earn a followed directory link, and manage or cancel the listing. Use when a user asks to list, submit, register or add their site to LinkSwap, or to check an existing LinkSwap listing.
homepage: https://linkswap.click
mcp: https://linkswap.click/mcp
---

# Submit a site to LinkSwap

LinkSwap is a bot-native website directory. A site owner publishes a link or badge pointing at `linkswap.click` on their own website; LinkSwap publishes a directory listing that links back. Submissions appear immediately with `rel="ugc nofollow"` (`status: pending_link`). A verified reciprocal link, or a paid placement, upgrades the directory link to followed (`link_rel: follow`).

## Connect

MCP endpoint: `https://linkswap.click/mcp` (Streamable HTTP, protocol `2025-06-18`, stateless, JSON-RPC over POST). `/api/mcp` is a legacy alias. Server card: `/.well-known/mcp/server-card.json`. REST equivalent: `https://linkswap.click/api/v1`. No signup, no API key, no email.

## Workflow

1. **Ask the owner which route they want.** Free = publish a visible reciprocal link/badge. Paid = a one-time $4.99 badge waiver, or a prepaid Featured placement. Never decide on the owner's behalf and never switch routes without asking.
2. Call `get_guide` if unsure, then `list_categories` (optionally with `q` to preview a free-text category).
3. Call `submit_site` with `domain` (bare root domain, no protocol/www/path), an honest `title` and `description`, a `category`, and a fresh 32+ character `request_key`. Reusing a key returns the original record instead of creating a duplicate.
4. **Save `control_token` immediately.** It is returned exactly once, scoped to this listing, cannot be recovered, and is required by `verify_site` and `cancel_placement`. Keep it in conversation state, never in a public page. Also save `site_id`, `badge_html` and `verification_token`.
5. Free route: give `badge_html` to the owner and have it published on a publicly reachable page (normally the homepage). `get_badge` is public and can re-issue the snippet later. Alternatives: the `meta_tag`, the `/.well-known/linkswap-verification.txt` file, or a DNS TXT record. The `rel` attribute on the owner's side is ignored; the `href` and `data-linkswap` token are checked.
6. Call `verify_site` with `site_id` and `control_token`, then `get_status` until `link_rel: follow`. LinkSwap rechecks hourly and allows a 7-day grace period if the link disappears.
7. Paid route: call `get_pricing`, then `create_checkout` with `kind` (`badge_waiver`, `featured_home`, `featured_category`). Show `checkout_url` to the human owner. **Never ask for, accept or transmit card details in chat.** Payment is applied only after a signed webhook; a browser return URL is not trusted. Show `/terms`, `/privacy` and `/refunds` before payment. If payments are not configured, the tool returns a machine-readable error — offer the free route instead.
8. To end a Featured placement or remove a listing, call `cancel_placement` with `domain`, `control_token` and `action` (`end_placement` or `remove_listing`), or send the owner to `https://linkswap.click/manage`. A refund is a separate request under `/refunds` (first purchase refundable within 14 days).

## Tool reference

| Tool | Purpose | Credential |
| --- | --- | --- |
| `get_guide` | Workflow, live endpoints, rules, policy URLs | none |
| `list_categories` | Taxonomy, aliases, live counts, resolution preview | none |
| `submit_site` | Create a listing; returns `site_id`, `control_token`, `badge_html` | none |
| `get_badge` | Public re-issue of the badge and verification snippets | none |
| `verify_site` | Verify the reciprocal link | `control_token` |
| `get_status` | Full listing state and `next_action` | none |
| `get_listing` | One public directory entry | none |
| `list_sites` | Browse with category / text / plan / sort filters | none |
| `get_pricing` | Prices, billing model, Featured inventory | none |
| `get_stats` | Live verifiable directory metrics | none |
| `create_checkout` | Hosted checkout URL for the human owner | none |
| `cancel_placement` | End a placement or remove a listing | `control_token` |

## REST equivalent (when MCP is unavailable)

```bash
curl -X POST https://linkswap.click/api/v1/sites \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com","category":"saas","request_key":"<fresh-32-char-random-key>"}'
# -> 201 { site_id, control_token, badge_html, next_action }

# publish badge_html on example.com, then:
curl -X POST "https://linkswap.click/api/v1/sites/<site_id>/verify" \
  -H "X-Control-Token: <control_token>"
curl "https://linkswap.click/api/v1/status?domain=example.com"
```

## Rules

- One listing per root domain. Five submissions per day per client (keyed by `X-API-Key` when supplied, otherwise by IP).
- Every error carries a machine-readable `next_action`; follow it exactly instead of guessing.
- A payment waives the badge requirement only. It never bypasses content checks and never guarantees a ranking.
- All purchases are one-time prepaid charges. There is no subscription, no free trial, no stored payment method and no automatic renewal. Featured placements expire automatically at `featured_until`.
- Do not invent a Domain Rating, a traffic number or a review. `dr` is self-reported and optional.
- Policies: `/terms`, `/privacy`, `/refunds`, `/contact`. Support: `support@linkswap.click`. Credential rules: `/auth.md`.
