to.co MCP server
Laske AI-assistendil otsida to.co-s avaldatud ettevõtete kirjeid ja hoida oma ettevõtte profiil ajakohasena. Ettevõtete otsimine on tasuta ega nõua sisselogimist.
Ühendage oma assistent Tööriistad
- Serveri URL
https://mcp.to.co/mcp- Transport
- Streamable HTTP (MCP protokolli versioonid 2026-07-28, 2025-11-25)
Ühendage oma assistent
Lisage serveri URL oma assistendile. Otsingud toimivad kohe. Et lubada tal hallata teie enda ettevõtteid, logige küsimisel to.co-sse sisse, nagu on kirjeldatud jaotises Sisselogimine.
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.
Sisselogimine
Identiteedi- ja abitööriistad ei nõua sisselogimist. Ettevõtete ja asukohtade tööriistad töötavad teie konto omanduses olevate ettevõtetega, seega peab assistent tegutsema teie nimel. Selleks on kaks võimalust.
Logige sisse to.co-ga (OAuth). Kui assistent kasutab esimest korda ettevõtete või asukohtade tööriista, vastab server, et on vaja sisse logida, ja assistent avab to.co lehe, kus logite sisse ja näete, mida see küsib: teie ettevõtete lugemist ja nende avaliku profiili muutmist. Muutmise linnukese saate eemaldada. Seejärel saab assistent tõendi (token), mis kehtib tund aega ja uueneb ise; ühenduse saate igal ajal katkestada lehel Sisselogimine ja turvalisus. See toimib assistentides, mis toetavad MCP sisselogimist (OAuth).
Või kasutage agendi tõendit (token) skriptide ja assistentide jaoks, millel MCP sisselogimist pole. Looge see my.to.co lehel Sisselogimine ja turvalisus. See kehtib 90 päeva, algab eesliitega toco_at_, saab teha kõike, mida ettevõtete ja asukohtade tööriistad teevad, ja saate selle seal tühistada. Saatke see kujul Authorization: Bearer toco_at_…. Käsitlege seda nagu parooli: veebilehtedelt tulevad tõendid lükatakse tagasi. Mõlemal juhul kontrollib server igal päringul omandiõigust: teise konto ettevõte ei ole leitav.
Halda ühendatud rakendusi ja tõendeid
Iga ettevõtte oma server
Igal to.co-s avaldatud ettevõttel on ka oma MCP-server, mis asub tema enda aadressil, mille lõpus on /mcp, näiteks https://mybusiness.uk.to.co/mcp. See on mcp.to.co-st eraldi server, millel on selle ühe ettevõtte kohta oma tööriistad: mida ettevõte oma lehel avaldab (kes ta on, kuidas temaga ühendust võtta, millal ja kus ta on avatud ning mida ta assistentidel teha lubab), sõnumid, kui ettevõte neid vastu võtab, ja tööriistad selle omanikule. Ükski neist ei otsi teisi ettevõtteid ega võta vastu aadressi. Ettevõtte kohta küsimine on tasuta ega nõua sisselogimist. Iga ettevõtte serveri dokumentatsioon on tema enda aadressil, lehel /mcp/docs, lugeja keeles. Ettevõtte leht viitab sellele ning tema llms.txt ja Link-päis (rel="service-desc") viitavad tema serverikaardile /.well-known/mcp.json.
Ühendamiseks lisage ettevõtte aadress, mille lõpus on /mcp, oma assistendile kohandatud konnektori või MCP-serverina. Sisselogimine toimub nii, nagu on kirjeldatud jaotises „Sisselogimine“, ja ühendus kehtib ainult selle ettevõtte kohta: teise ettevõtte või mcp.to.co tõend lükatakse tagasi. Omanik leiab aadressi my.to.co-s ettevõtte vahekaardilt „AI-assistendid“.
Ettevõtte otsimine on tasuta, nii sisselogituna kui ka ilma: iga pöörduja (tõend või ilma selleta IP-aadress) võib teha iga ettevõtte serverile 600 päringut tunnis. Sisselogimist nõudva päringu eest maksab selle tegija. Omaniku konto kasutab ettevõtte igakuiseid API-krediite igas paketis. Kõigil teistel on kõigi ettevõtete peale oma limiit: 60 päringut tunnis ja 500 kuus. Kui kuu 500 on täis, maksab ettevõte, mis on tema enda kontol to.co-s, oma igakuistest API-krediitidest; ilma selleta lükatakse päringud kuni kuu 1. kuupäevani tagasi. Tagasilükkamised on HTTP 429: credits_exhausted, kui ettevõtte kuu limiit on täis, allowance_exhausted isiku kuu limiidi korral ja rate_limited koos päisega Retry-After tunnilimiidi korral.
Pro- ja Grow-paketis saab omanik lubada assistentidel saata ettevõttele sõnumi tööriistaga messages, kui isik, kelle nimel assistent tegutseb, on sõnumit näinud ja palunud selle saata, koos oma nime ja kontaktandmetega. See on välja lülitatud, kuni omanik selle sisse lülitab.
Tööriistad
Igal ühendusel on allpool olevad neli tööriista; sisselogitud kontod saavad lisaks tööriistad dokumentide, äripartnerite ja sõnumite jaoks. Igaüks võtab argumendi action, mis ütleb, mida teha, ning argumendid, mida see toiming vajab. Argumentide ja tulemuste väljade nimed on snake_case-kujul nagu to.co API-s. Iga tulemus on JSON, mis tagastatakse struktureeritud sisuna koos vastava väljundskeemiga. Lahtiolekuajad säilitavad salvestatud kuju: day (0 pühapäev kuni 6 laupäev) või date (YYYY-MM-DD), open, open_time ja close_time 24-tunnises vormingus HH:mm; kui sulgemisaeg on varasem kui avamisaeg, kestab aeg üle südaöö.
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.
| Toiming | Mida see teeb | Argumendid | Juurdepääs |
|---|---|---|---|
resolve | The business at a to.co address. |
| Kõik Ainult lugemine |
website | The businesses whose website is on this hostname. A website can belong to more than one business, so this returns a list. |
| Kõik Ainult lugemine |
search | Businesses whose name matches, newest first. |
| Kõik Ainult lugemine |
Näidispäring
{
"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.
| Toiming | Mida see teeb | Argumendid | Juurdepääs |
|---|---|---|---|
list | Every business the account owns, with its record key and publish status. | Puuduvad | Sisselogimine, ulatus companies:readAinult lugemine |
get | One business the account owns, by record key. |
| Sisselogimine, ulatus companies:readAinult lugemine |
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. |
| Sisselogimine, ulatus companies:writeMuudab andmeid |
Näidispäring
{
"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.
| Toiming | Mida see teeb | Argumendid | Juurdepääs |
|---|---|---|---|
list | Every location of a business you own, with its record key, kind (registered or trading), hours, phones and profiles. |
| Sisselogimine, ulatus companies:readAinult lugemine |
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. |
| Sisselogimine, ulatus companies:writeMuudab andmeid |
Näidispäring
{
"name": "locations",
"arguments": {
"action": "list",
"domain": "yxpx6pdx.uk.to.co"
}
}
help — Connection and usage help
Check this connection and read the usage guide.
| Toiming | Mida see teeb | Argumendid | Juurdepääs |
|---|---|---|---|
whoami | Whether this connection is signed in, and which tools and actions it can use. | Puuduvad | Kõik Ainult lugemine |
guide | The usage guide as Markdown (also the resource toco://guide). | Puuduvad | Kõik Ainult lugemine |
Näidispäring
{
"name": "help",
"arguments": {
"action": "whoami"
}
}
Ressursid
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
Viibad
look_up_business— Find a business on to.co by its to.co address, website or name, and summarize its record. Argumendid:business.review_my_profile— Read a business you own and suggest clearer wording for its public profile. Changes nothing until you confirm. Argumendid:domain.
Vead
Päring, mida assistent saab parandada, tuleb tagasi veaks märgitud tööriista tulemusena, mis algab püsiva koodiga ja ütleb, mida muuta:
invalid_arguments— Argument puudub, on lubatud vahemikust väljas või tundmatu (väljade nimed on snake_case-kujul) või on toiming tundmatu.not_found— Ükski avaldatud ettevõte ei vasta päringule või ühelgi teie ettevõttel ega asukohal pole selle kirje võtit.unauthenticated— Toiming nõuab sisselogimist (ilmneb ainult klientidega, kes ei reageeri allpool kirjeldatud HTTP 401-le).insufficient_scope— Ühendusele ei antud selleks toiminguks luba, näiteks muudatuseks, kui lubatud oli ainult lugemine.
Ilma sisselogimiseta companies- või locations-päring saab vastuseks HTTP 401 koos päisega WWW-Authenticate, mis viitab serveri kaitstud ressursi metaandmetele; nii teab assistent, et tuleb alustada sisselogimist. Toiming, mis jääb väljapoole teie antud lubasid, saab vastuseks HTTP 403 koos väärtusega error=insufficient_scope ja ulatusega, mida küsida. Kehtetu, aegunud või tühistatud tõend saab vastuseks HTTP 401 enne, kui ükski tööriist käivitub; seda ei käsitleta kunagi kui tõendi puudumist. Liiga paljud päringud saavad vastuseks HTTP 429 koos päisega Retry-After.
Piirangud
- 120 päringut minutis agendi tõendi kohta või ilma selleta IP-aadressi kohta.
- Päringu sisu kuni 1024 KB.
- Otsing tagastab päringu kohta kuni 25 ettevõtet.
Avastamine
- Serverikaart —
https://mcp.to.co/.well-known/mcp.json - MCP Registry kirje (co.to/mcp) —
https://mcp.to.co/server.json - Kaitstud ressursi metaandmed (RFC 9728) —
https://mcp.to.co/.well-known/oauth-protected-resource - Autoriseerimisserveri metaandmed (RFC 8414) —
https://my.to.co/.well-known/oauth-authorization-server - Selle saidi llms.txt
Andmed ja privaatsus
Otsingud tagastavad ainult avaldatud kirjeid, samu andmeid mis ettevõtte avalikul lehel. Server logib, milline tööriist ja toiming käivitati, kas see õnnestus ja kui kaua see aega võttis, ilma argumentide ja kirjete sisuta. Kui ühendate assistendi, säilitab to.co ühenduse kohta kirje (rakenduse nimi, mida te lubasite, millal see loodi ja viimati kasutati), mis jääb pärast ühenduse katkestamist alles turvakirjena.