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 Herramientas
- URL del servidor
https://mcp.to.co/mcp- Transporte
- Streamable HTTP (revisiones del protocolo MCP 2026-07-28, 2025-11-25)
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)
- 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.
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
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.
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.
| Acción | Qué hace | Argumentos | Acceso |
|---|---|---|---|
resolve | The business at a to.co address. |
| Cualquiera Solo lectura |
website | The businesses whose website is on this hostname. A website can belong to more than one business, so this returns a list. |
| Cualquiera Solo lectura |
search | Businesses whose name matches, newest first. |
| Cualquiera Solo lectura |
Ejemplo de llamada
{
"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.
| Acción | Qué hace | Argumentos | Acceso |
|---|---|---|---|
list | Every business the account owns, with its record key and publish status. | Ninguno | Inicio de sesión, ámbito companies:readSolo lectura |
get | One business the account owns, by record key. |
| Inicio de sesión, ámbito companies:readSolo lectura |
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. |
| Inicio de sesión, ámbito companies:writeModifica datos |
Ejemplo de llamada
{
"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.
| Acción | Qué hace | Argumentos | Acceso |
|---|---|---|---|
list | Every location of a business you own, with its record key, kind (registered or trading), hours, phones and profiles. |
| Inicio de sesión, ámbito companies:readSolo lectura |
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. |
| Inicio de sesión, ámbito companies:writeModifica datos |
Ejemplo de llamada
{
"name": "locations",
"arguments": {
"action": "list",
"domain": "yxpx6pdx.uk.to.co"
}
}
help — Connection and usage help
Check this connection and read the usage guide.
| Acción | Qué hace | Argumentos | Acceso |
|---|---|---|---|
whoami | Whether this connection is signed in, and which tools and actions it can use. | Ninguno | Cualquiera Solo lectura |
guide | The usage guide as Markdown (also the resource toco://guide). | Ninguno | Cualquiera Solo lectura |
Ejemplo de llamada
{
"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 - llms.txt de este sitio
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.