Serverul MCP to.co
Lăsați un asistent AI să caute fișe de firmă publicate pe to.co și să vă țină la zi propriul profil de firmă. Căutarea firmelor este gratuită și nu cere conectare.
Conectați-vă asistentul Instrumente
- URL-ul serverului
https://mcp.to.co/mcp- Transport
- Streamable HTTP (revizii ale protocolului MCP 2026-07-28, 2025-11-25)
Conectați-vă asistentul
Adăugați URL-ul serverului în asistentul dvs. Căutările funcționează imediat. Pentru a-i permite să vă gestioneze firmele, conectați-vă la to.co când vă cere, așa cum este descris la Conectare.
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.
Conectare
Instrumentele de identitate și de ajutor nu cer conectare. Instrumentele pentru societăți și locații lucrează asupra firmelor pe care le deține contul dvs., deci asistentul trebuie să acționeze în numele dvs. Există două moduri.
Conectați-vă cu to.co (OAuth). Când asistentul folosește prima dată instrumentul pentru societăți sau locații, serverul răspunde că este nevoie de conectare, iar asistentul deschide o pagină to.co unde vă conectați și vedeți ce cere: citirea firmelor dvs. și modificarea profilului lor public. Puteți debifa modificările. Apoi primește un token valabil o oră, care se reînnoiește singur; îl puteți deconecta oricând în pagina Conectare și securitate. Funcționează în asistenții care acceptă conectarea MCP (OAuth).
Sau folosiți un token de agent, pentru scripturi și asistenți fără conectare MCP. Creați unul în pagina Conectare și securitate din my.to.co. Este valabil 90 de zile, începe cu toco_at_, poate face tot ce fac instrumentele pentru societăți și locații și îl puteți revoca acolo. Trimiteți-l ca Authorization: Bearer toco_at_…. Tratați-l ca pe o parolă: tokenurile sunt refuzate din paginile web. În ambele cazuri, serverul controlează proprietatea la fiecare apel: firma altui cont este citită ca „negăsită”.
Gestionați aplicațiile conectate și tokenurile
Serverul propriu al fiecărei firme
Fiecare firmă publicată pe to.co are și propriul server MCP, la adresa ei, cu /mcp la sfârșit, de exemplu https://mybusiness.uk.to.co/mcp. Este un server separat de mcp.to.co, cu instrumente proprii despre acea firmă: ce publică pe pagină (cine este, cum poate fi contactată, când și unde este deschisă și ce le permite asistenților să facă), mesajele, acolo unde firma le primește, și instrumente pentru proprietar. Niciunul nu caută o altă firmă și niciunul nu primește o adresă. Întrebările despre firmă sunt gratuite și nu cer conectare. Serverul fiecărei firme este documentat la propria adresă, la /mcp/docs, în limba cititorului. Pagina firmei trimite la el, iar llms.txt și un antet Link (rel="service-desc") indică fișa serverului, /.well-known/mcp.json.
Pentru a vă conecta, adăugați adresa firmei, terminată în /mcp, în asistentul dvs. ca „custom connector” sau server MCP. Conectarea funcționează ca la Conectare, iar conexiunea este doar pentru acea firmă: un token pentru altă firmă sau pentru mcp.to.co este refuzat. Proprietarul găsește adresa în my.to.co, în fila Asistenți AI a firmei.
Căutarea unei firme nu costă nimic, conectat sau nu: fiecare apelant (un token sau, fără el, o adresă IP) poate face 600 căutări pe oră pe serverul fiecărei firme. Un apel care cere conectare este plătit de cel care îl face. Contul proprietarului folosește creditele API lunare ale firmei, pe orice plan. Oricine altcineva are o alocare proprie pentru toate firmele: 60 apeluri pe oră și 500 pe lună. După cele 500 ale lunii, o firmă pe care contul lor o are pe to.co plătește din creditele API lunare; fără una, apelurile sunt refuzate până pe 1. Refuzurile sunt HTTP 429: credits_exhausted când luna firmei este epuizată, allowance_exhausted pentru luna persoanei și rate_limited cu Retry-After pentru o oră.
Pe Pro și Grow, proprietarul poate permite asistenților să trimită firmei un mesaj cu instrumentul messages, după ce persoana în numele căreia acționează asistentul l-a văzut și a cerut trimiterea lui, cu propriul nume și propriile date de contact. Este oprit până când proprietarul îl pornește.
Instrumente
Fiecare conexiune are cele patru instrumente de mai jos; conturile conectate primesc și instrumente pentru documente, parteneri comerciali și mesaje. Fiecare primește un argument action care spune ce de făcut, plus argumentele de care are nevoie acțiunea. Numele argumentelor și ale câmpurilor din rezultat sunt în snake_case, ca la API-ul to.co. Fiecare rezultat este JSON, returnat ca structured content cu o schemă de ieșire corespunzătoare. Programul își păstrează forma stocată: day (0 pentru duminică până la 6 pentru sâmbătă) sau date (YYYY-MM-DD), open, open_time și close_time în format de 24 de ore HH:mm, o oră de închidere mai devreme decât cea de deschidere însemnând trecerea peste miezul nopții.
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.
| Acțiune | Ce face | Argumente | Acces |
|---|---|---|---|
resolve | The business at a to.co address. |
| Oricine Doar citire |
website | The businesses whose website is on this hostname. A website can belong to more than one business, so this returns a list. |
| Oricine Doar citire |
search | Businesses whose name matches, newest first. |
| Oricine Doar citire |
Exemplu de apel
{
"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.
| Acțiune | Ce face | Argumente | Acces |
|---|---|---|---|
list | Every business the account owns, with its record key and publish status. | Niciunul | Conectare, domeniu de acces companies:readDoar citire |
get | One business the account owns, by record key. |
| Conectare, domeniu de acces companies:readDoar citire |
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. |
| Conectare, domeniu de acces companies:writeModifică date |
Exemplu de apel
{
"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.
| Acțiune | Ce face | Argumente | Acces |
|---|---|---|---|
list | Every location of a business you own, with its record key, kind (registered or trading), hours, phones and profiles. |
| Conectare, domeniu de acces companies:readDoar citire |
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. |
| Conectare, domeniu de acces companies:writeModifică date |
Exemplu de apel
{
"name": "locations",
"arguments": {
"action": "list",
"domain": "yxpx6pdx.uk.to.co"
}
}
help — Connection and usage help
Check this connection and read the usage guide.
| Acțiune | Ce face | Argumente | Acces |
|---|---|---|---|
whoami | Whether this connection is signed in, and which tools and actions it can use. | Niciunul | Oricine Doar citire |
guide | The usage guide as Markdown (also the resource toco://guide). | Niciunul | Oricine Doar citire |
Exemplu de apel
{
"name": "help",
"arguments": {
"action": "whoami"
}
}
Resurse
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
Prompturi
look_up_business— Find a business on to.co by its to.co address, website or name, and summarize its record. Argumente:business.review_my_profile— Read a business you own and suggest clearer wording for its public profile. Changes nothing until you confirm. Argumente:domain.
Erori
Un apel pe care asistentul îl poate corecta revine ca rezultat de instrument marcat ca eroare, începând cu un cod stabil și spunând ce trebuie schimbat:
invalid_arguments— Un argument lipsește, este în afara intervalului sau necunoscut (numele câmpurilor sunt în snake_case), sau acțiunea este necunoscută.not_found— Nicio firmă publicată nu se potrivește sau nicio firmă ori locație pe care o dețineți nu are acea cheie de fișă.unauthenticated— Acțiunea cere conectare (se vede doar la clienții care nu reacționează la HTTP 401 de mai jos).insufficient_scope— Conexiunii nu i s-a permis această acțiune, de exemplu o modificare când s-a permis doar citirea.
Un apel pentru societăți sau locații fără conectare primește HTTP 401 cu un antet WWW-Authenticate care indică metadatele resursei protejate ale serverului, așa știe asistentul să înceapă conectarea. O acțiune în afara a ceea ce ați permis primește HTTP 403 cu error=insufficient_scope și domeniul de acces de cerut. Un token invalid, expirat sau revocat primește HTTP 401 înainte să ruleze orice instrument; nu este tratat niciodată ca lipsă de token. Prea multe cereri primesc HTTP 429 cu un antet Retry-After.
Limite
- 120 cereri pe minut pe token de agent sau, fără token, pe adresă IP.
- Corpuri de cerere de până la 1024 KB.
- Căutarea returnează până la 25 firme per apel.
Descoperire
- Fișa serverului —
https://mcp.to.co/.well-known/mcp.json - Intrare în MCP Registry (co.to/mcp) —
https://mcp.to.co/server.json - Metadatele resursei protejate (RFC 9728) —
https://mcp.to.co/.well-known/oauth-protected-resource - Metadatele serverului de autorizare (RFC 8414) —
https://my.to.co/.well-known/oauth-authorization-server - llms.txt pentru acest site
Date și confidențialitate
Căutările returnează doar fișe publicate, aceleași fapte ca pe pagina publică a firmei. Serverul înregistrează ce instrument și ce acțiune au rulat, dacă a mers și cât a durat, fără argumente și fără conținutul fișei. Când conectați un asistent, to.co păstrează o evidență a conexiunii (numele aplicației, ce ați permis, când a fost creată și folosită ultima dată), care rămâne ca înregistrare de securitate după deconectare.