Domovská stránka to.co
Začať

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.

Prepojenie asistenta Nástroje

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)

  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.
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.
{
  "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.
{
  "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.
{
  "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.

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íArgumentyPrístup
resolveThe business at a to.co address.
  • host string, povinné A to.co address, e.g. mybusiness.uk.to.co or mybusiness-bristol.biz.to.co
Ktokoľvek
Len na čítanie
websiteThe businesses whose website is on this hostname. A website can belong to more than one business, so this returns a list.
  • website string, povinné The business's own website, e.g. mybusiness.com or https://www.mybusiness.com/
Ktokoľvek
Len na čítanie
searchBusinesses whose name matches, newest first.
  • query string, povinné Part of the business name, at least 2 characters
  • limit integer Maximum results, 1-25 (default 10)
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íArgumentyPrístup
listEvery business the account owns, with its record key and publish status.ŽiadnePrihlásenie, rozsah companies:read
Len na čítanie
getOne business the account owns, by record key.
  • domain string, povinné The record key of a company you own, as returned by companies list (the `domain` field)
Prihlásenie, rozsah companies:read
Len na čítanie
updateChange 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, povinné 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
Prihlásenie, rozsah companies:write
Mení ú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íArgumentyPrístup
listEvery location of a business you own, with its record key, kind (registered or trading), hours, phones and profiles.
  • domain string, povinné The record key of a company you own, as returned by companies list (the `domain` field)
Prihlásenie, rozsah companies:read
Len na čítanie
updateSet 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, povinné The record key of a company you own, as returned by companies list (the `domain` field)
  • location string, povinné 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
Prihlásenie, rozsah companies:write
Mení ú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íArgumentyPrístup
whoamiWhether this connection is signed in, and which tools and actions it can use.ŽiadneKtokoľvek
Len na čítanie
guideThe usage guide as Markdown (also the resource toco://guide).ŽiadneKtokoľ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

Ú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.

Ďalšie kroky

Jazyk