**Serveur MCP** · [API](https://to.co/fr-ca/docs/api?format=md)

# 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](#connect) · [Outils](#tools)

- URL du serveur: `https://mcp.to.co/mcp`
- Transport: Streamable HTTP (révisions du protocole MCP 2026-07-28, 2025-11-25)

<a id="connect"></a>
## 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)

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.

```sh
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.

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

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

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

## 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](https://my.to.co/account/security)

<a id="business"></a>
## 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.

<a id="tools"></a>
## 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.

- `resolve` (tout le monde, lecture seule): The business at a to.co address.
  - `host` (string, obligatoire): A to.co address, e.g. mybusiness.uk.to.co or mybusiness-bristol.biz.to.co
- `website` (tout le monde, lecture seule): The businesses whose website is on this hostname. A website can belong to more than one business, so this returns a list.
  - `website` (string, obligatoire): The business's own website, e.g. mybusiness.com or https://www.mybusiness.com/
- `search` (tout le monde, lecture seule): Businesses whose name matches, newest first.
  - `query` (string, obligatoire): Part of the business name, at least 2 characters
  - `limit` (integer): Maximum results, 1-25 (default 10)

Exemple d’appel:

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

- `list` (connexion, portée `companies:read`, lecture seule): Every business the account owns, with its record key and publish status.
- `get` (connexion, portée `companies:read`, lecture seule): One business the account owns, by record key.
  - `domain` (string, obligatoire): The record key of a company you own, as returned by companies list (the `domain` field)
- `update` (connexion, portée `companies:write`, modifie des données): 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.
  - `domain` (string, obligatoire): 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

Exemple d’appel:

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

- `list` (connexion, portée `companies:read`, lecture seule): Every location of a business you own, with its record key, kind (registered or trading), hours, phones and profiles.
  - `domain` (string, obligatoire): The record key of a company you own, as returned by companies list (the `domain` field)
- `update` (connexion, portée `companies:write`, modifie des données): 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.
  - `domain` (string, obligatoire): The record key of a company you own, as returned by companies list (the `domain` field)
  - `location` (string, obligatoire): 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

Exemple d’appel:

```json
{
  "name": "locations",
  "arguments": {
    "action": "list",
    "domain": "yxpx6pdx.uk.to.co"
  }
}
```

### `help` — Connection and usage help

Check this connection and read the usage guide.

- `whoami` (tout le monde, lecture seule): Whether this connection is signed in, and which tools and actions it can use.
- `guide` (tout le monde, lecture seule): The usage guide as Markdown (also the resource toco://guide).

Exemple d’appel:

```json
{
  "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

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

## Étapes suivantes

- [Lire l’article de lancement](https://to.co/fr-ca/blog/mcp-server)
- [Commencer](https://my.to.co/claim)
