MCP сървърът на to.co
Позволете на AI асистент да търси публикувани записи на фирми в to.co и да поддържа актуален собствения ви профил на фирмата. Търсенето на фирми е безплатно и не изисква вход.
Свържете асистента си Инструменти
- Адрес на сървъра
https://mcp.to.co/mcp- Транспорт
- Streamable HTTP (ревизии на протокола MCP 2026-07-28, 2025-11-25)
Свържете асистента си
Добавете адреса на сървъра към асистента си. Търсенията работят веднага. За да му позволите да управлява собствените ви фирми, влезте в to.co, когато поиска, както е описано в „Вход“.
Claude (claude.ai and the desktop app)
- Open Settings, then Connectors, and choose Add custom connector.
- Name it to.co and enter https://mcp.to.co/mcp as the URL.
- 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
- 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.
claude mcp add --transport http toco https://mcp.to.co/mcp
Cursor
- 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.
{
"mcpServers": {
"toco": {
"url": "https://mcp.to.co/mcp"
}
}
}
VS Code
- 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.
{
"servers": {
"toco": {
"type": "http",
"url": "https://mcp.to.co/mcp"
}
}
}
ChatGPT
- In Settings, open Apps and connectors and turn on developer mode under Advanced.
- Create a connector with https://mcp.to.co/mcp as the server URL and OAuth as the authentication.
Windsurf
- 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.
{
"mcpServers": {
"toco": {
"serverUrl": "https://mcp.to.co/mcp",
"headers": {
"Authorization": "Bearer toco_at_…"
}
}
}
}
Any other client
- Use Streamable HTTP at https://mcp.to.co/mcp.
- 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_…. Отнасяйте се към него като към парола: токените се отказват от уеб страници. И в двата случая сървърът проверява собствеността при всяко извикване: фирма на друг акаунт се чете като не е намерена.
Управление на свързани приложения и токени
Собственият сървър на всяка фирма
Всяка публикувана фирма в 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, след като човекът, от чието име действа асистентът, го е видял и е поискал да бъде изпратено, със собственото си име и данни за контакт. Изключено е, докато собственикът не го включи.
Инструменти
Всяка връзка има четирите инструмента по-долу; акаунтите с вход получават и инструменти за документи, търговски партньори и съобщения. Всеки приема аргумент 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. |
| Всеки Само за четене |
website | The businesses whose website is on this hostname. A website can belong to more than one business, so this returns a list. |
| Всеки Само за четене |
search | Businesses whose name matches, newest first. |
| Всеки Само за четене |
Пример за извикване
{
"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 | Every business the account owns, with its record key and publish status. | Няма | Вход, обхват companies:readСамо за четене |
get | One business the account owns, by record key. |
| Вход, обхват companies:readСамо за четене |
update | 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. |
| Вход, обхват companies:writeПроменя данни |
Пример за извикване
{
"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 | Every location of a business you own, with its record key, kind (registered or trading), hours, phones and profiles. |
| Вход, обхват companies:readСамо за четене |
update | 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. |
| Вход, обхват companies:writeПроменя данни |
Пример за извикване
{
"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). | Няма | Всеки Само за четене |
Пример за извикване
{
"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 - llms.txt на този сайт
Данни и поверителност
Търсенията връщат само публикувани записи, същите факти като на публичната страница на фирмата. Сървърът записва кой инструмент и действие са се изпълнили, дали е сработило и колко време е отнело, без аргументи и без съдържание на записи. Когато свържете асистент, to.co пази запис на връзката (името на приложението, какво сте разрешили, кога е създадена и последно използвана), който остава като запис за сигурност, след като я прекъснете.