Server MCP to.co
Nechajte asistenta AI vyhľadávať zverejnené záznamy firiem na to.co a udržiavať aktuálny profil vašej firmy. Vyhľadávanie firiem je zadarmo a nevyžaduje prihlásenie.
- Adresa URL servera
https://mcp.to.co/mcp- Prenos
- Streamable HTTP (revízie protokolu MCP 2026-07-28, 2025-11-25)
Prepojenie asistenta
Pridajte adresu URL servera do svojho asistenta. Vyhľadávanie funguje hneď. Ak mu chcete umožniť spravovať vaše vlastné firmy, prihláste sa do to.co, keď o to požiada, podľa popisu v časti Prihlásenie.
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.
Prihlásenie
Nástroje pre totožnosť a pomoc nevyžadujú prihlásenie. Nástroje pre firmy a miesta pracujú s firmami, ktoré váš účet vlastní, takže asistent musí konať ako vy. Sú dva spôsoby.
Prihlásenie cez to.co (OAuth). Keď asistent prvýkrát použije nástroj pre firmy alebo miesta, server odpovie, že potrebuje prihlásenie, a asistent otvorí stránku to.co, kde sa prihlásite a uvidíte, o čo žiada: čítanie vašich firiem a zmeny ich verejného profilu. Zmeny môžete odškrtnúť. Potom dostane token, ktorý platí hodinu a sám sa obnovuje; môžete ho kedykoľvek odpojiť na stránke Prihlásenie a zabezpečenie. Funguje to v asistentoch, ktoré podporujú prihlásenie MCP (OAuth).
Alebo použite token agenta, pre skripty a asistentov bez prihlásenia MCP. Vytvoríte ho na stránke Prihlásenie a zabezpečenie v my.to.co. Platí 90 dní, začína sa toco_at_, dokáže všetko, čo nástroje pre firmy a miesta, a môžete ho tam zrušiť. Posielajte ho ako Authorization: Bearer toco_at_…. Zaobchádzajte s ním ako s heslom: tokeny sa z webových stránok odmietajú. V oboch prípadoch server pri každom volaní kontroluje vlastníctvo: firma iného účtu sa javí ako nenájdená.
Spravovať pripojené aplikácie a tokeny
Vlastný server každej firmy
Každá zverejnená firma na to.co má aj vlastný server MCP na vlastnej adrese s /mcp na konci, napríklad https://mybusiness.uk.to.co/mcp. Je to samostatný server od mcp.to.co s vlastnými nástrojmi o tejto jednej firme: čo zverejňuje na svojej stránke (kto je, ako ju zastihnúť, kedy a kde má otvorené a čo asistentom dovoľuje), správy tam, kde ich firma prijíma, a nástroje pre jej vlastníka. Žiadny z nich nevyhľadáva inú firmu a žiadny neprijíma adresu. Dopytovanie sa na firmu je zadarmo a nevyžaduje prihlásenie. Server každej firmy je zdokumentovaný na jej vlastnej adrese, na /mcp/docs, v jazyku čitateľa. Stránka firmy naň odkazuje a jej llms.txt a hlavička Link (rel="service-desc") ukazujú na kartu servera /.well-known/mcp.json.
Na pripojenie pridajte adresu firmy zakončenú /mcp do svojho asistenta ako vlastný konektor alebo server MCP. Prihlásenie funguje podľa popisu v časti Prihlásenie a prepojenie platí len pre túto firmu: token pre inú firmu alebo pre mcp.to.co sa odmietne. Vlastník nájde adresu v my.to.co na karte Asistenti AI danej firmy.
Vyhľadávanie firmy nestojí nič, prihlásený či nie: každý volajúci (token, alebo IP adresa, ak ho nemá) môže robiť 600 vyhľadávaní za hodinu na serveri každej firmy. Volanie, ktoré vyžaduje prihlásenie, platí ten, kto ho robí. Účet vlastníka využíva mesačné kredity API firmy v každom tarife. Ktokoľvek iný má vlastný limit naprieč všetkými firmami: 60 volaní za hodinu a 500 za mesiac. Po prekročení 500 za mesiac platí firma, ktorú má jeho vlastný účet na to.co, z jej mesačných kreditov API; bez nej sa volania odmietajú do 1. dňa v mesiaci. Odmietnutia sú HTTP 429: credits_exhausted, keď je mesiac firmy vyčerpaný, allowance_exhausted pre mesiac osoby a rate_limited s Retry-After pre hodinu.
V tarifoch Pro a Grow môže vlastník asistentom umožniť poslať firme správu nástrojom messages, keď osoba, za ktorú asistent koná, správu videla a požiadala o jej odoslanie, s vlastným menom a kontaktnými údajmi. Je to vypnuté, kým to vlastník nezapne.
Nástroje
Každé pripojenie má štyri nižšie uvedené nástroje; prihlásené účty majú aj nástroje pre doklady, obchodných partnerov a správy. Každý prijíma argument action, ktorý určuje, čo robiť, a argumenty, ktoré daná akcia potrebuje. Názvy argumentov a polí výsledku sú v snake_case, ako v API to.co. Každý výsledok je JSON, vrátený ako štruktúrovaný obsah s príslušnou výstupnou schémou. Otváracie hodiny si zachovávajú uloženú podobu: day (0 pre nedeľu až 6 pre sobotu) alebo date (YYYY-MM-DD), open, open_time a close_time v 24-hodinovom tvare HH:mm, pričom čas zatvorenia skorší ako čas otvorenia znamená presah za polnoc.
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.
| Akcia | Čo robí | Argumenty | Prístup |
|---|---|---|---|
resolve | The business at a to.co address. |
| Ktokoľvek Len na čítanie |
website | The businesses whose website is on this hostname. A website can belong to more than one business, so this returns a list. |
| Ktokoľvek Len na čítanie |
search | Businesses whose name matches, newest first. |
| Ktokoľvek Len na čítanie |
Ukážkové volanie
{
"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.
| Akcia | Čo robí | Argumenty | Prístup |
|---|---|---|---|
list | Every business the account owns, with its record key and publish status. | Žiadne | Prihlásenie, rozsah companies:readLen na čítanie |
get | One business the account owns, by record key. |
| Prihlásenie, rozsah companies:readLen na čítanie |
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. |
| Prihlásenie, rozsah companies:writeMení údaje |
Ukážkové volanie
{
"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.
| Akcia | Čo robí | Argumenty | Prístup |
|---|---|---|---|
list | Every location of a business you own, with its record key, kind (registered or trading), hours, phones and profiles. |
| Prihlásenie, rozsah companies:readLen na čítanie |
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. |
| Prihlásenie, rozsah companies:writeMení údaje |
Ukážkové volanie
{
"name": "locations",
"arguments": {
"action": "list",
"domain": "yxpx6pdx.uk.to.co"
}
}
help — Connection and usage help
Check this connection and read the usage guide.
| Akcia | Čo robí | Argumenty | Prístup |
|---|---|---|---|
whoami | Whether this connection is signed in, and which tools and actions it can use. | Žiadne | Ktokoľvek Len na čítanie |
guide | The usage guide as Markdown (also the resource toco://guide). | Žiadne | Ktokoľvek Len na čítanie |
Ukážkové volanie
{
"name": "help",
"arguments": {
"action": "whoami"
}
}
Zdroje
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
Výzvy
look_up_business— Find a business on to.co by its to.co address, website or name, and summarize its record. Argumenty:business.review_my_profile— Read a business you own and suggest clearer wording for its public profile. Changes nothing until you confirm. Argumenty:domain.
Chyby
Volanie, ktoré asistent môže opraviť, sa vráti ako výsledok nástroja označený ako chyba, začínajúci stabilným kódom a s uvedením, čo zmeniť:
invalid_arguments— Argument chýba, je mimo rozsahu alebo neznámy (názvy polí sú v snake_case), alebo je neznáma akcia.not_found— Nezodpovedá žiadna zverejnená firma, alebo žiadna firma ani miesto, ktoré vlastníte, nemá tento kľúč záznamu.unauthenticated— Akcia vyžaduje prihlásenie (vidno len pri klientoch, ktorí nekonajú podľa nižšie uvedeného HTTP 401).insufficient_scope— Pripojenie nemalo túto akciu povolenú, napríklad zmenu, keď bolo povolené len čítanie.
Volanie pre firmy alebo miesta bez prihlásenia dostane HTTP 401 s hlavičkou WWW-Authenticate odkazujúcou na metadáta chráneného zdroja servera, podľa čoho asistent vie, že má začať prihlásenie. Akcia mimo toho, čo ste povolili, dostane HTTP 403 s error=insufficient_scope a rozsahom, o ktorý treba požiadať. Neplatný, vypršaný alebo zrušený token dostane HTTP 401 skôr, než sa spustí akýkoľvek nástroj; nikdy sa nepovažuje za chýbajúci token. Príliš veľa požiadaviek dostane HTTP 429 s hlavičkou Retry-After.
Limity
- 120 požiadaviek za minútu na token agenta, alebo na IP adresu, ak ho nemá.
- Telá požiadaviek do 1024 KB.
- Vyhľadávanie vráti najviac 25 firiem na jedno volanie.
Zisťovanie
- Karta servera —
https://mcp.to.co/.well-known/mcp.json - Záznam v registri MCP (co.to/mcp) —
https://mcp.to.co/server.json - Metadáta chráneného zdroja (RFC 9728) —
https://mcp.to.co/.well-known/oauth-protected-resource - Metadáta autorizačného servera (RFC 8414) —
https://my.to.co/.well-known/oauth-authorization-server - llms.txt pre tento web
Údaje a súkromie
Vyhľadávania vracajú len zverejnené záznamy, rovnaké fakty ako verejná stránka firmy. Server zaznamenáva, ktorý nástroj a akcia sa spustili, či sa to podarilo a ako dlho to trvalo, bez argumentov a obsahu záznamov. Keď pripojíte asistenta, to.co uchováva záznam o prepojení (názov aplikácie, čo ste povolili, kedy bolo vytvorené a naposledy použité), ktorý po odpojení zostáva ako bezpečnostný záznam.