**MCP сървър** · [API](https://to.co/bg-bg/docs/api?format=md)

# MCP сървърът на to.co

Позволете на AI асистент да търси публикувани записи на фирми в to.co и да поддържа актуален собствения ви профил на фирмата. Търсенето на фирми е безплатно и не изисква вход.

[Свържете асистента си](#connect) · [Инструменти](#tools)

- Адрес на сървъра: `https://mcp.to.co/mcp`
- Транспорт: Streamable HTTP (ревизии на протокола MCP 2026-07-28, 2025-11-25)

<a id="connect"></a>
## Свържете асистента си

Добавете адреса на сървъра към асистента си. Търсенията работят веднага. За да му позволите да управлява собствените ви фирми, влезте в to.co, когато поиска, както е описано в „Вход“.

### Claude (claude.ai and the desktop app)

1. Open Settings, then Connectors, and choose Add custom connector.
2. Name it to.co and enter https://mcp.to.co/mcp as the URL.
3. Leave the client ID and secret empty. Lookups work at once; to let Claude work on your own businesses, sign in to to.co and choose Allow when it asks.

### Claude Code

1. Run this in a terminal, then run /mcp in Claude Code and choose toco to sign in when you want the companies and locations tools.

```sh
claude mcp add --transport http toco https://mcp.to.co/mcp
```

### Cursor

1. Add this to ~/.cursor/mcp.json (or .cursor/mcp.json in a project). Cursor asks you to sign in to to.co when the companies or locations tool first needs it.

```json
{
  "mcpServers": {
    "toco": {
      "url": "https://mcp.to.co/mcp"
    }
  }
}
```

### VS Code

1. Add this to .vscode/mcp.json, then start the server from the MCP view. VS Code asks you to sign in to to.co when the companies or locations tool first needs it.

```json
{
  "servers": {
    "toco": {
      "type": "http",
      "url": "https://mcp.to.co/mcp"
    }
  }
}
```

### ChatGPT

1. In Settings, open Apps and connectors and turn on developer mode under Advanced.
2. Create a connector with https://mcp.to.co/mcp as the server URL and OAuth as the authentication.

### Windsurf

1. Add this to ~/.codeium/windsurf/mcp_config.json. The Authorization header, with an agent token, is needed only for the companies and locations tools; leave it out for lookups.

```json
{
  "mcpServers": {
    "toco": {
      "serverUrl": "https://mcp.to.co/mcp",
      "headers": {
        "Authorization": "Bearer toco_at_…"
      }
    }
  }
}
```

### Any other client

1. Use Streamable HTTP at https://mcp.to.co/mcp.
2. For the companies and locations tools, sign in with OAuth (the server advertises https://my.to.co in its protected resource metadata) or send Authorization: Bearer with an agent token.

## Вход

Инструментите за самоличност и помощ не изискват вход. Инструментите за фирми и обекти работят с фирмите, които акаунтът ви притежава, така че асистентът трябва да действа от ваше име. Има два начина.

Вход с to.co (OAuth). Когато асистентът за първи път използва инструмента за фирми или обекти, сървърът отговаря, че е нужен вход, и асистентът отваря страница на to.co, където влизате и виждате какво иска: да чете вашите фирми и да променя публичния им профил. Можете да отмаркирате промените. След това получава токен, който важи един час и се подновява сам; можете да го прекъснете по всяко време на страницата „Вход и сигурност“. Това работи в асистенти, които поддържат вход през MCP (OAuth).

Или използвайте токен на агент, за скриптове и асистенти без вход през MCP. Създайте го на страницата „Вход и сигурност“ в my.to.co. Важи 90 дни, започва с toco_at_, може да прави всичко, което инструментите за фирми и обекти правят, и можете да го отмените там. Изпращайте го като Authorization: Bearer toco_at_…. Отнасяйте се към него като към парола: токените се отказват от уеб страници. И в двата случая сървърът проверява собствеността при всяко извикване: фирма на друг акаунт се чете като не е намерена.

[Управление на свързани приложения и токени](https://my.to.co/account/security)

<a id="business"></a>
## Собственият сървър на всяка фирма

Всяка публикувана фирма в to.co има и собствен MCP сървър, на собствения си адрес с /mcp накрая, например https://mybusiness.uk.to.co/mcp. Това е отделен сървър от mcp.to.co, със собствени инструменти за тази една фирма: какво публикува на страницата си (коя е, как да се свържете с нея, кога и къде работи и какво позволява на асистентите), съобщения, когато фирмата ги приема, и инструменти за нейния собственик. Нито един от тях не търси друга фирма и нито един не приема адрес. Питането за фирмата е безплатно и не изисква вход. Сървърът на всяка фирма е документиран на нейния адрес, на /mcp/docs, на езика на читателя. Страницата на фирмата сочи към него, а нейният llms.txt и заглавка Link (rel="service-desc") сочат към картата на сървъра, /.well-known/mcp.json.

За да се свържете, добавете адреса на фирмата, завършващ на /mcp, към асистента си като потребителски конектор или MCP сървър. Входът работи както е описано в „Вход“, а връзката е само за тази фирма: токен за друга фирма или за mcp.to.co се отказва. Собственикът намира адреса в my.to.co, в раздела „AI асистенти“ на фирмата.

Търсенето на фирма не струва нищо, с вход или без: всеки извикващ (токен или, без такъв, IP адрес) може да прави 600 търсения на час на сървъра на всяка фирма. Извикване, което изисква вход, се заплаща от този, който го прави. Акаунтът на собственика използва месечните API кредити на фирмата, във всеки план. Всеки друг има собствен лимит за всички фирми: 60 извиквания на час и 500 на месец. След 500 за месеца фирма, която собственият му акаунт има в to.co, плаща от месечните си API кредити; без такава извикванията се отказват до 1-во число. Отказите са HTTP 429: credits_exhausted, когато месецът на фирмата е изразходван, allowance_exhausted за месеца на човека и rate_limited с Retry-After за един час.

В Pro и Grow собственикът може да позволи на асистентите да изпращат съобщение до фирмата с инструмента messages, след като човекът, от чието име действа асистентът, го е видял и е поискал да бъде изпратено, със собственото си име и данни за контакт. Изключено е, докато собственикът не го включи.

<a id="tools"></a>
## Инструменти

Всяка връзка има четирите инструмента по-долу; акаунтите с вход получават и инструменти за документи, търговски партньори и съобщения. Всеки приема аргумент action, който казва какво да се направи, плюс аргументите, които това действие изисква. Имената на аргументите и полетата на резултата са в snake_case, както в API на to.co. Всеки резултат е JSON, върнат като структурирано съдържание със съответстваща изходна схема. Работното време запазва съхранения си вид: day (0 за неделя до 6 за събота) или date (YYYY-MM-DD), open, open_time и close_time в 24-часов формат HH:mm, като час на затваряне по-ранен от часа на отваряне преминава след полунощ.

### `identity` — Look up a business identity

Look up published business identities on to.co. Anyone can call it; no sign-in needed. Records are the public projection: never internal keys or account details.

- `resolve` (всеки, само за четене): The business at a to.co address.
  - `host` (string, задължителен): A to.co address, e.g. mybusiness.uk.to.co or mybusiness-bristol.biz.to.co
- `website` (всеки, само за четене): The businesses whose website is on this hostname. A website can belong to more than one business, so this returns a list.
  - `website` (string, задължителен): The business's own website, e.g. mybusiness.com or https://www.mybusiness.com/
- `search` (всеки, само за четене): Businesses whose name matches, newest first.
  - `query` (string, задължителен): Part of the business name, at least 2 characters
  - `limit` (integer): Maximum results, 1-25 (default 10)

Пример за извикване:

```json
{
  "name": "identity",
  "arguments": {
    "action": "resolve",
    "host": "mybusiness.uk.to.co"
  }
}
```

### `companies` — Manage your businesses

Read and update the businesses the connected account owns, drafts included. Needs the person to sign in (OAuth) or an agent token; only the owning account can read or change a record.

- `list` (вход, обхват `companies:read`, само за четене): Every business the account owns, with its record key and publish status.
- `get` (вход, обхват `companies:read`, само за четене): One business the account owns, by record key.
  - `domain` (string, задължителен): The record key of a company you own, as returned by companies list (the `domain` field)
- `update` (вход, обхват `companies:write`, променя данни): Change profile fields and publish the page again. Fields you leave out keep their value; an empty string or null clears one. A registered company takes its official name from the company register, so its name cannot be changed; set informal_name instead.
  - `domain` (string, задължителен): The record key of a company you own, as returned by companies list (the `domain` field)
  - `name` (string): The name of a business that is not registered. Refused for a registered company
  - `informal_name` (string): A shorter everyday name. An empty string or null clears it
  - `description` (string): What the business does, up to 2000 characters. An empty string or null clears it
  - `website_url` (string): The business website, a full https:// URL. An empty string or null clears it
  - `email` (string): A public contact email. A new address is shown on the page only after its owner confirms it from a link emailed to it; the old one stays until then. An empty string or null clears it
  - `phones` (object): Phone numbers by kind; kinds you leave out keep their value. Whether to.co verified a number is read-only
  - `links` (object): Links shown as actions on the page; links you leave out keep their value
  - `keywords` (string): Search keywords, up to 1000 characters. An empty string or null clears it
  - `category` (string): The business category shown on the page, e.g. Bakery. An empty string or null clears it
  - `vat_registration_number` (string): An optional VAT, GST or other tax registration number for the company's home country. Up to 100 characters; upper-cased, and anything but letters and digits removed. Where the country has a rule (the EU, the UK, Switzerland, Norway, Australia, New Zealand, Canada, India) its format and check digit are checked and a number that fails is refused; EU and UK numbers are saved with their country prefix. An empty string or null clears it
  - `contact_preferences` (object): How the business prefers to be contacted by to.co: true or false for email, sms, post and tel
  - `social_links` (object): Social profiles by network (linkedin, x, instagram, facebook, youtube, tiktok, pinterest, vimeo, snapchat, clubhouse): a profile link, or a handle for x and instagram. An empty string or null removes one

Пример за извикване:

```json
{
  "name": "companies",
  "arguments": {
    "action": "list"
  }
}
```

### `locations` — Manage your trading locations

Read the locations of a business the connected account owns, and set the description, opening hours, phone numbers and social profiles of its trading locations. These changes keep a location verified. The registered office comes from the company register and cannot be changed here; moving an address needs new proof, in the to.co app.

- `list` (вход, обхват `companies:read`, само за четене): Every location of a business you own, with its record key, kind (registered or trading), hours, phones and profiles.
  - `domain` (string, задължителен): The record key of a company you own, as returned by companies list (the `domain` field)
- `update` (вход, обхват `companies:write`, променя данни): Set the description, opening hours, special hours, phone numbers or social profiles of a trading location and publish the page again. Hours replace the current ones; fields you leave out keep their value. Phone numbers are saved as international numbers; the answer's checks say what was changed, and a value that cannot be accepted is refused, naming the field.
  - `domain` (string, задължителен): The record key of a company you own, as returned by companies list (the `domain` field)
  - `location` (string, задължителен): The record key of a trading location, as returned by locations list (the `domain` field)
  - `description` (string): What this location offers: its own services, products and benefits, in plain words (no name, address, phone, email, links or prices; they are checked and removed). An empty string or null clears it
  - `normal_hours` (array): Weekly opening hours, replacing the current ones: one entry per slot, up to 4 a day; a day with no entry or open false is closed. [] or null clears them
  - `special_hours` (array): Holiday and closure hours that replace the weekly hours on their date, replacing the current list. [] or null clears them
  - `phones` (object): Phone numbers by kind; kinds you leave out keep their value. Whether to.co verified a number is read-only
  - `social_links` (object): Social profiles by network (linkedin, x, instagram, facebook, youtube, tiktok, pinterest, vimeo, snapchat, clubhouse): a profile link, or a handle for x and instagram. An empty string or null removes one

Пример за извикване:

```json
{
  "name": "locations",
  "arguments": {
    "action": "list",
    "domain": "yxpx6pdx.uk.to.co"
  }
}
```

### `help` — Connection and usage help

Check this connection and read the usage guide.

- `whoami` (всеки, само за четене): Whether this connection is signed in, and which tools and actions it can use.
- `guide` (всеки, само за четене): The usage guide as Markdown (also the resource toco://guide).

Пример за извикване:

```json
{
  "name": "help",
  "arguments": {
    "action": "whoami"
  }
}
```

## Ресурси

- `toco://guide` (text/markdown): How to look businesses up and keep your own profile current, with examples.
- `toco://identity/{host}` (application/json): The published record at a to.co address, as JSON. Example: toco://identity/mybusiness.uk.to.co

## Подсказки

- `look_up_business`: Find a business on to.co by its to.co address, website or name, and summarize its record. Аргументи: `business`.
- `review_my_profile`: Read a business you own and suggest clearer wording for its public profile. Changes nothing until you confirm. Аргументи: `domain`.

## Грешки

Извикване, което асистентът може да поправи, се връща като резултат на инструмент, отбелязан като грешка, започващ със стабилен код и казващ какво да се промени:

- `invalid_arguments`: Липсва аргумент, той е извън допустимия диапазон или е неизвестен (имената на полетата са в snake_case), или действието е неизвестно.
- `not_found`: Няма съвпадаща публикувана фирма или няма фирма или обект, които притежавате, с този ключ на записа.
- `unauthenticated`: Действието изисква вход (вижда се само при клиенти, които не действат по HTTP 401 по-долу).
- `insufficient_scope`: На връзката не е позволено това действие, например промяна, когато е позволено само четене.

Извикване за фирми или обекти без вход получава HTTP 401 със заглавка WWW-Authenticate, сочеща към метаданните на защитения ресурс на сървъра, по което асистентът разбира, че трябва да започне вход. Действие извън позволеното от вас получава HTTP 403 с error=insufficient_scope и обхвата, който да се поиска. Невалиден, изтекъл или отменен токен получава HTTP 401, преди да се изпълни какъвто и да е инструмент; никога не се третира като липса на токен. Твърде много заявки получават HTTP 429 със заглавка Retry-After.

## Ограничения

- 120 заявки в минута на токен на агент или, без такъв, на IP адрес.
- Тела на заявки до 1024 KB.
- Търсенето връща до 25 фирми на извикване.

## Откриване

- Карта на сървъра: https://mcp.to.co/.well-known/mcp.json
- Запис в MCP Registry (co.to/mcp): https://mcp.to.co/server.json
- Метаданни на защитения ресурс (RFC 9728): https://mcp.to.co/.well-known/oauth-protected-resource
- Метаданни на сървъра за оторизация (RFC 8414): https://my.to.co/.well-known/oauth-authorization-server

## Данни и поверителност

Търсенията връщат само публикувани записи, същите факти като на публичната страница на фирмата. Сървърът записва кой инструмент и действие са се изпълнили, дали е сработило и колко време е отнело, без аргументи и без съдържание на записи. Когато свържете асистент, to.co пази запис на връзката (името на приложението, какво сте разрешили, кога е създадена и последно използвана), който остава като запис за сигурност, след като я прекъснете.

## Следващи стъпки

- [Прочетете публикацията за старта](https://to.co/en-us/blog/mcp-server)
- [Започнете](https://my.to.co/claim)
