# Collaborator MCP

> Collaborator.pro link building - the site catalog for guest posts and your deals as an advertiser or a site owner.

Lets an agent work with [Collaborator.pro](https://collaborator.pro), the
link-building marketplace: search the catalog of sites for guest posts and
sponsored articles by price and SEO metrics, and read your deals - the
placements you ordered as an advertiser and the orders on your own sites.
Every method is a read; ordering, payments and chat with site owners stay on
collaborator.pro.

Product page: [flymy.ai/mcp/collaborator](https://flymy.ai/mcp/collaborator/)

## What it can do

| Method | What it does |
| --- | --- |
| `collaborator_get_account_capabilities` | Your account role (customer or owner) and the API features open to it. |
| `collaborator_search_sites` | Search the site catalog by keywords, countries, regions, cities, site languages, price, Ahrefs DR and traffic, Majestic TF/CF, Moz DA, SDR, Google index and News, site type, link type, links per article, placement speed, insurance and sensitive topics. Returns traffic, metrics and prices per placement format. |
| `collaborator_list_deals` | Deals you ordered as a customer: project, site, status, anchors, dates, prices and the published URL. Filter by project. |
| `collaborator_list_owner_deals` | Deals on your own sites as a site owner: status, task, customer, prices, and whether the article is on the site and in Google's index. |
| `collaborator_list_countries` | Countries and their ids for the catalog filters. |
| `collaborator_list_regions` | Regions of a country and their ids. |
| `collaborator_list_cities` | Cities of a region and their ids. |
| `collaborator_list_languages` | Site languages and their ids. |

## How to get credentials

Every Collaborator account already has an API token.

1. Sign in at [collaborator.pro](https://collaborator.pro).
2. Open **Personal profile** → **API**
   ([collaborator.pro/user/api](https://collaborator.pro/user/api)).
3. Copy the token.

Collaborator support opens the site catalog API (`collaborator_search_sites`)
per account: ask them at
[collaborator.pro/contact-us](https://collaborator.pro/contact-us). Deals and
the dictionaries work without it.

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `COLLABORATOR_API_KEY` | Personal profile → API → token |

## Troubleshooting

- **HTTP 401** - Collaborator rejected the token. Copy it again from Personal
  profile → API and reconnect Collaborator.
- **`collaborator_search_sites` is refused** - the catalog API is not opened
  for your account yet. Ask Collaborator support to enable it; reconnecting
  does not change it.
- **No deals** - call `collaborator_get_account_capabilities`: a customer
  account has its deals in `collaborator_list_deals`, a site owner in
  `collaborator_list_owner_deals`.

## Links

- [Collaborator API](https://collaborator.pro/api)
- [API reference](https://collaborator.pro/api/public/default/docs)
- [How to integrate the Collaborator API](https://collaborator.pro/blog/how-to-integrate-collaborator-api)
