**Servidor MCP** · [API](https://to.co/es-mx/docs/api?format=md)

# El servidor MCP de to.co

Permite que un asistente de IA busque fichas de empresa publicadas en to.co y mantenga al día el perfil de tu propio negocio. Buscar negocios es gratis y no requiere iniciar sesión.

[Conecta tu asistente](#connect) · [Herramientas](#tools)

- URL del servidor: `https://mcp.to.co/mcp`
- Transporte: Streamable HTTP (revisiones del protocolo MCP 2026-07-28, 2025-11-25)

<a id="connect"></a>
## Conecta tu asistente

Añade la URL del servidor a tu asistente. Las búsquedas funcionan desde el primer momento. Para que gestione tus propios negocios, inicia sesión en to.co cuando te lo pida, como se explica en Inicio de sesión.

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

## Inicio de sesión

Las herramientas identity y help no requieren iniciar sesión. Las herramientas companies y locations trabajan con los negocios de los que es propietaria tu cuenta, así que el asistente tiene que actuar en tu nombre. Hay dos formas.

Inicia sesión con to.co (OAuth). Cuando el asistente usa por primera vez la herramienta companies o locations, el servidor responde que necesita iniciar sesión, y el asistente abre una página de to.co donde inicias sesión y ves qué pide: leer tus negocios y cambiar su perfil público. Puedes desmarcar los cambios. Después recibe un token que dura una hora y se renueva solo; puedes desconectarlo en cualquier momento en la página Inicio de sesión y seguridad. Esto funciona en los asistentes compatibles con el inicio de sesión de MCP (OAuth).

O usa un token de agente, para scripts y asistentes sin inicio de sesión de MCP. Créalo en la página Inicio de sesión y seguridad de my.to.co. Dura 90 días, empieza por toco_at_, puede hacer todo lo que hacen las herramientas companies y locations, y puedes revocarlo allí. Envíalo como Authorization: Bearer toco_at_…. Trátalo como una contraseña: los tokens se rechazan si llegan desde páginas web. En ambos casos, el servidor comprueba la propiedad en cada llamada: el negocio de otra cuenta aparece como no encontrado.

[Gestionar aplicaciones conectadas y tokens](https://my.to.co/account/security)

<a id="business"></a>
## El servidor propio de cada empresa

Cada empresa publicada en to.co tiene también su propio servidor MCP, en su propia dirección con /mcp al final, por ejemplo https://mybusiness.uk.to.co/mcp. Es un servidor distinto de mcp.to.co, con herramientas propias sobre esa única empresa: lo que publica en su página (quién es, cómo contactar con ella, cuándo y dónde abre, y qué permite hacer a los asistentes), los mensajes donde la empresa los acepta y herramientas para su propietario. Ninguna consulta otra empresa y ninguna acepta una dirección. Preguntar por la empresa es gratis y no requiere iniciar sesión. El servidor de cada empresa está documentado en su propia dirección, en /mcp/docs, en el idioma de quien lo lee. La página de la empresa enlaza a él, y su llms.txt y una cabecera Link (rel="service-desc") apuntan a su ficha de servidor, /.well-known/mcp.json.

Para conectarte, añade la dirección de la empresa, terminada en /mcp, a tu asistente como conector personalizado o servidor MCP. El inicio de sesión funciona como se describe en Inicio de sesión, y la conexión sirve solo para esa empresa: se rechaza un token de otra empresa o de mcp.to.co. El propietario encuentra la dirección en my.to.co, en la pestaña Asistentes de IA de la empresa.

Consultar una empresa no cuesta nada, con sesión o sin ella: cada llamante (un token o, sin él, una dirección IP) puede hacer 600 consultas por hora en el servidor de cada empresa. Una llamada que requiere iniciar sesión la paga quien la hace. La cuenta del propietario usa los créditos de API mensuales de la empresa, en todos los planes. Cualquier otra persona tiene su propia asignación para todas las empresas: 60 llamadas por hora y 500 al mes. Pasadas las 500 del mes, paga con sus créditos de API mensuales una empresa de su propia cuenta en to.co; sin una, las llamadas se rechazan hasta el día 1. Los rechazos son HTTP 429: credits_exhausted cuando se agota el mes de la empresa, allowance_exhausted para el mes de la persona y rate_limited con Retry-After para una hora.

En Pro y Grow, el propietario puede permitir que los asistentes envíen un mensaje a la empresa con la herramienta messages, una vez que la persona para la que actúa el asistente lo ha visto y ha pedido enviarlo, con su propio nombre y datos de contacto. Está desactivado hasta que el propietario lo activa.

<a id="tools"></a>
## Herramientas

Cada conexión tiene las cuatro herramientas siguientes; las cuentas con sesión iniciada también tienen herramientas para documentos, socios comerciales y mensajes. Cada una recibe un argumento action que indica qué hacer, más los argumentos que necesita esa acción. Los nombres de los argumentos y de los campos del resultado van en snake_case, como en la API de to.co. Todos los resultados son JSON y se devuelven como contenido estructurado con el esquema de salida correspondiente. El horario conserva el formato en que se guarda: day (de 0 para el domingo a 6 para el sábado) o date (YYYY-MM-DD), open, open_time y close_time en formato de 24 horas HH:mm; si la hora de cierre es anterior a la de apertura, el horario continúa pasada la medianoche.

### `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` (cualquiera, solo lectura): The business at a to.co address.
  - `host` (string, obligatorio): A to.co address, e.g. mybusiness.uk.to.co or mybusiness-bristol.biz.to.co
- `website` (cualquiera, solo lectura): The businesses whose website is on this hostname. A website can belong to more than one business, so this returns a list.
  - `website` (string, obligatorio): The business's own website, e.g. mybusiness.com or https://www.mybusiness.com/
- `search` (cualquiera, solo lectura): Businesses whose name matches, newest first.
  - `query` (string, obligatorio): Part of the business name, at least 2 characters
  - `limit` (integer): Maximum results, 1-25 (default 10)

Ejemplo de llamada:

```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` (inicio de sesión, ámbito `companies:read`, solo lectura): Every business the account owns, with its record key and publish status.
- `get` (inicio de sesión, ámbito `companies:read`, solo lectura): One business the account owns, by record key.
  - `domain` (string, obligatorio): The record key of a company you own, as returned by companies list (the `domain` field)
- `update` (inicio de sesión, ámbito `companies:write`, modifica datos): 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, obligatorio): 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

Ejemplo de llamada:

```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` (inicio de sesión, ámbito `companies:read`, solo lectura): Every location of a business you own, with its record key, kind (registered or trading), hours, phones and profiles.
  - `domain` (string, obligatorio): The record key of a company you own, as returned by companies list (the `domain` field)
- `update` (inicio de sesión, ámbito `companies:write`, modifica datos): 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, obligatorio): The record key of a company you own, as returned by companies list (the `domain` field)
  - `location` (string, obligatorio): 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

Ejemplo de llamada:

```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` (cualquiera, solo lectura): Whether this connection is signed in, and which tools and actions it can use.
- `guide` (cualquiera, solo lectura): The usage guide as Markdown (also the resource toco://guide).

Ejemplo de llamada:

```json
{
  "name": "help",
  "arguments": {
    "action": "whoami"
  }
}
```

## Recursos

- `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. Argumentos: `business`.
- `review_my_profile`: Read a business you own and suggest clearer wording for its public profile. Changes nothing until you confirm. Argumentos: `domain`.

## Errores

Una llamada que el asistente puede corregir se devuelve como un resultado de herramienta marcado como error, que empieza por un código estable e indica qué hay que cambiar:

- `invalid_arguments`: Falta un argumento, está fuera de rango o es desconocido (los nombres de campo van en snake_case), o la acción es desconocida.
- `not_found`: No hay ningún negocio publicado que coincida, o ninguno de los negocios o ubicaciones de los que eres propietario tiene esa clave de registro.
- `unauthenticated`: La acción requiere iniciar sesión (solo aparece con clientes que no actúan ante el HTTP 401 que se describe más abajo).
- `insufficient_scope`: La conexión no tenía permiso para esta acción; por ejemplo, un cambio cuando solo se permitió leer.

Una llamada a companies o locations sin iniciar sesión recibe un HTTP 401 con una cabecera WWW-Authenticate que apunta a los metadatos de recurso protegido del servidor; así sabe el asistente que debe iniciar sesión. Una acción fuera de lo que permitiste recibe un HTTP 403 con error=insufficient_scope y el ámbito que hay que solicitar. Un token no válido, caducado o revocado recibe un HTTP 401 antes de que se ejecute ninguna herramienta; nunca se trata como si no hubiera token. Demasiadas solicitudes reciben un HTTP 429 con una cabecera Retry-After.

## Límites

- 120 solicitudes por minuto por token de agente o, sin token, por dirección IP.
- Cuerpos de solicitud de hasta 1024 KB.
- La búsqueda devuelve hasta 25 negocios por llamada.

## Descubrimiento

- Tarjeta del servidor: https://mcp.to.co/.well-known/mcp.json
- Entrada en el MCP Registry (co.to/mcp): https://mcp.to.co/server.json
- Metadatos de recurso protegido (RFC 9728): https://mcp.to.co/.well-known/oauth-protected-resource
- Metadatos del servidor de autorización (RFC 8414): https://my.to.co/.well-known/oauth-authorization-server

## Datos y privacidad

Las búsquedas devuelven solo fichas publicadas, con los mismos datos que la página pública del negocio. El servidor registra qué herramienta y qué acción se ejecutaron, si funcionaron y cuánto tardaron, sin argumentos ni contenido de las fichas. Cuando conectas un asistente, to.co guarda un registro de la conexión (el nombre de la aplicación, lo que permitiste, cuándo se creó y cuándo se usó por última vez), que se conserva como registro de seguridad después de desconectarlo.

## Siguientes pasos

- [Leer la entrada del lanzamiento](https://to.co/es-mx/blog/mcp-server)
- [Empezar](https://my.to.co/claim)
