Le serveur MCP de to.co
Permettez à un assistant IA de rechercher les fiches d’entreprise publiées sur to.co et de tenir à jour le profil de votre propre entreprise. La recherche d’entreprises est gratuite et ne nécessite aucune connexion.
Connectez votre assistant Outils
- URL du serveur
https://mcp.to.co/mcp- Transport
- Streamable HTTP (révisions du protocole MCP 2026-07-28, 2025-11-25)
Connectez votre assistant
Ajoutez l’URL du serveur à votre assistant. Les recherches fonctionnent immédiatement. Pour lui permettre de gérer vos propres entreprises, connectez-vous à to.co lorsqu’il vous le demande, comme décrit dans la section Connexion.
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.
Connexion
Les outils identity et help ne nécessitent aucune connexion. Les outils companies et locations agissent sur les entreprises dont votre compte est propriétaire : l’assistant doit donc agir en votre nom. Il existe deux méthodes.
Connexion avec to.co (OAuth). Lorsque l’assistant utilise pour la première fois l’outil companies ou locations, le serveur répond qu’une connexion est nécessaire, et l’assistant ouvre une page to.co où vous vous connectez et voyez ce qu’il demande : lire vos entreprises et modifier leur profil public. Vous pouvez décocher les modifications. Il reçoit ensuite un jeton valable une heure, qui se renouvelle automatiquement ; vous pouvez le déconnecter à tout moment sur la page Connexion et sécurité. Cela fonctionne avec les assistants qui prennent en charge la connexion MCP (OAuth).
Vous pouvez aussi utiliser un jeton d’agent, pour les scripts et les assistants sans connexion MCP. Créez-en un sur la page Connexion et sécurité de my.to.co. Il est valable 90 jours, commence par toco_at_, peut faire tout ce que font les outils companies et locations, et vous pouvez le révoquer depuis cette page. Envoyez-le sous la forme Authorization: Bearer toco_at_…. Traitez-le comme un mot de passe : les jetons sont refusés lorsqu’ils proviennent de pages web. Dans les deux cas, le serveur vérifie la propriété à chaque appel : l’entreprise d’un autre compte est traitée comme introuvable.
Gérer les applications connectées et les jetons
Le serveur propre à chaque entreprise
Chaque entreprise publiée sur to.co a aussi son propre serveur MCP, à sa propre adresse suivie de /mcp, par exemple https://mybusiness.uk.to.co/mcp. C’est un serveur distinct de mcp.to.co, avec ses propres outils sur cette seule entreprise : ce qu’elle publie sur sa page (qui elle est, comment la joindre, quand et où elle est ouverte, et ce qu’elle permet aux assistants), les messages là où l’entreprise en reçoit, et des outils pour son propriétaire. Aucun ne consulte une autre entreprise, et aucun ne prend d’adresse. Interroger l’entreprise est gratuit et ne demande aucune connexion. Le serveur de chaque entreprise est documenté à sa propre adresse, sous /mcp/docs, dans la langue du lecteur. La page de l’entreprise y renvoie, et son llms.txt et un en-tête Link (rel="service-desc") renvoient à sa fiche serveur, /.well-known/mcp.json.
Pour vous connecter, ajoutez l’adresse de l’entreprise, terminée par /mcp, à votre assistant comme connecteur personnalisé ou serveur MCP. La connexion fonctionne comme décrit sous Connexion, et elle ne vaut que pour cette entreprise : un jeton pour une autre entreprise, ou pour mcp.to.co, est refusé. Le propriétaire trouve l’adresse dans my.to.co, dans l’onglet Assistants d’IA de l’entreprise.
Consulter une entreprise ne coûte rien, connecté ou non : chaque appelant (un jeton ou, sans jeton, une adresse IP) peut faire 600 consultations par heure sur le serveur de chaque entreprise. Un appel qui demande une connexion est payé par qui le fait. Le compte du propriétaire utilise les crédits API mensuels de l’entreprise, quel que soit l’abonnement. Toute autre personne a son propre quota pour toutes les entreprises : 60 appels par heure et 500 par mois. Au-delà des 500 du mois, une entreprise de son propre compte sur to.co paie avec ses crédits API mensuels ; sans entreprise, les appels sont refusés jusqu’au 1er. Les refus sont des HTTP 429 : credits_exhausted quand le mois de l’entreprise est épuisé, allowance_exhausted pour le mois de la personne, et rate_limited avec Retry-After pour une heure.
Avec Pro et Grow, le propriétaire peut permettre aux assistants d’envoyer un message à l’entreprise avec l’outil messages, une fois que la personne pour qui l’assistant agit l’a vu et a demandé son envoi, avec ses propres nom et coordonnées. C’est désactivé tant que le propriétaire ne l’active pas.
Outils
Chaque connexion dispose des quatre outils ci-dessous ; les comptes connectés ont aussi des outils pour les documents, les partenaires commerciaux et les messages. Chacun prend un argument action qui indique quoi faire, ainsi que les arguments nécessaires à cette action. Les noms des arguments et des champs de résultat sont en snake_case, comme dans l’API de to.co. Chaque résultat est au format JSON, renvoyé sous forme de contenu structuré avec un schéma de sortie correspondant. Les horaires d’ouverture conservent leur forme enregistrée : day (de 0 pour dimanche à 6 pour samedi) ou date (YYYY-MM-DD), open, open_time et close_time au format 24 heures HH:mm ; une heure de fermeture antérieure à l’heure d’ouverture signifie que la plage se prolonge après minuit.
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.
| Action | Rôle | Arguments | Accès |
|---|---|---|---|
resolve | The business at a to.co address. |
| Tout le monde Lecture seule |
website | The businesses whose website is on this hostname. A website can belong to more than one business, so this returns a list. |
| Tout le monde Lecture seule |
search | Businesses whose name matches, newest first. |
| Tout le monde Lecture seule |
Exemple d’appel
{
"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.
| Action | Rôle | Arguments | Accès |
|---|---|---|---|
list | Every business the account owns, with its record key and publish status. | Aucun | Connexion, portée companies:readLecture seule |
get | One business the account owns, by record key. |
| Connexion, portée companies:readLecture seule |
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. |
| Connexion, portée companies:writeModifie des données |
Exemple d’appel
{
"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.
| Action | Rôle | Arguments | Accès |
|---|---|---|---|
list | Every location of a business you own, with its record key, kind (registered or trading), hours, phones and profiles. |
| Connexion, portée companies:readLecture seule |
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. |
| Connexion, portée companies:writeModifie des données |
Exemple d’appel
{
"name": "locations",
"arguments": {
"action": "list",
"domain": "yxpx6pdx.uk.to.co"
}
}
help — Connection and usage help
Check this connection and read the usage guide.
| Action | Rôle | Arguments | Accès |
|---|---|---|---|
whoami | Whether this connection is signed in, and which tools and actions it can use. | Aucun | Tout le monde Lecture seule |
guide | The usage guide as Markdown (also the resource toco://guide). | Aucun | Tout le monde Lecture seule |
Exemple d’appel
{
"name": "help",
"arguments": {
"action": "whoami"
}
}
Ressources
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
Prompts
look_up_business— Find a business on to.co by its to.co address, website or name, and summarize its record. Arguments :business.review_my_profile— Read a business you own and suggest clearer wording for its public profile. Changes nothing until you confirm. Arguments :domain.
Erreurs
Un appel que l’assistant peut corriger renvoie un résultat d’outil marqué comme erreur, qui commence par un code stable et indique ce qu’il faut changer :
invalid_arguments— Un argument est manquant, hors limites ou inconnu (les noms de champs sont en snake_case), ou l’action est inconnue.not_found— Aucune entreprise publiée ne correspond, ou aucune entreprise ni aucun établissement dont vous êtes propriétaire n’a cette clé de fiche.unauthenticated— L’action nécessite une connexion (ne s’affiche qu’avec les clients qui ne réagissent pas au code HTTP 401 décrit ci-dessous).insufficient_scope— La connexion n’a pas été autorisée pour cette action, par exemple une modification alors que seule la lecture était autorisée.
Un appel à companies ou locations sans connexion reçoit une réponse HTTP 401 avec un en-tête WWW-Authenticate qui renvoie vers les métadonnées de ressource protégée du serveur : c’est ainsi que l’assistant sait qu’il doit lancer la connexion. Une action qui dépasse ce que vous avez autorisé reçoit une réponse HTTP 403 avec error=insufficient_scope et la portée à demander. Un jeton non valide, expiré ou révoqué reçoit une réponse HTTP 401 avant l’exécution de tout outil ; il n’est jamais traité comme une absence de jeton. Un nombre excessif de requêtes reçoit une réponse HTTP 429 avec un en-tête Retry-After.
Limites
- 120 requêtes par minute par jeton d’agent, ou par adresse IP en l’absence de jeton.
- Corps de requête jusqu’à 1024 Ko.
- La recherche renvoie jusqu’à 25 entreprises par appel.
Découverte
- Carte du serveur —
https://mcp.to.co/.well-known/mcp.json - Entrée dans le MCP Registry (co.to/mcp) —
https://mcp.to.co/server.json - Métadonnées de ressource protégée (RFC 9728) —
https://mcp.to.co/.well-known/oauth-protected-resource - Métadonnées du serveur d’autorisation (RFC 8414) —
https://my.to.co/.well-known/oauth-authorization-server - llms.txt de ce site
Données et confidentialité
Les recherches ne renvoient que les fiches publiées, avec les mêmes informations que la page publique de l’entreprise. Le serveur journalise l’outil et l’action exécutés, leur réussite ou leur échec, et leur durée, sans aucun argument ni contenu de fiche. Lorsque vous connectez un assistant, to.co conserve une trace de la connexion (le nom de l’application, ce que vous avez autorisé, la date de création et de dernière utilisation), qui reste conservée à des fins de sécurité après la déconnexion.