Pagina principală to.co

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)

  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.

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țiuneCe faceArgumenteAcces
resolveThe business at a to.co address.
  • host string, obligatoriu A to.co address, e.g. mybusiness.uk.to.co or mybusiness-bristol.biz.to.co
Oricine
Doar citire
websiteThe businesses whose website is on this hostname. A website can belong to more than one business, so this returns a list.
  • website string, obligatoriu The business's own website, e.g. mybusiness.com or https://www.mybusiness.com/
Oricine
Doar citire
searchBusinesses whose name matches, newest first.
  • query string, obligatoriu Part of the business name, at least 2 characters
  • limit integer Maximum results, 1-25 (default 10)
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țiuneCe faceArgumenteAcces
listEvery business the account owns, with its record key and publish status.NiciunulConectare, domeniu de acces companies:read
Doar citire
getOne business the account owns, by record key.
  • domain string, obligatoriu The record key of a company you own, as returned by companies list (the `domain` field)
Conectare, domeniu de acces companies:read
Doar citire
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, obligatoriu 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
Conectare, domeniu de acces companies:write
Modifică 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țiuneCe faceArgumenteAcces
listEvery location of a business you own, with its record key, kind (registered or trading), hours, phones and profiles.
  • domain string, obligatoriu The record key of a company you own, as returned by companies list (the `domain` field)
Conectare, domeniu de acces companies:read
Doar citire
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, obligatoriu The record key of a company you own, as returned by companies list (the `domain` field)
  • location string, obligatoriu 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
Conectare, domeniu de acces companies:write
Modifică 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țiuneCe faceArgumenteAcces
whoamiWhether this connection is signed in, and which tools and actions it can use.NiciunulOricine
Doar citire
guideThe usage guide as Markdown (also the resource toco://guide).NiciunulOricine
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

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.

Pașii următori

Limba