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

# O servidor MCP do to.co

Deixe um assistente de IA consultar registros de negócios publicados no to.co e manter atualizado o perfil do seu próprio negócio. Consultar negócios é grátis e não exige login.

[Conecte seu assistente](#connect) · [Ferramentas](#tools)

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

<a id="connect"></a>
## Conecte seu assistente

Adicione a URL do servidor ao seu assistente. As consultas funcionam na hora. Para deixá-lo gerenciar seus próprios negócios, entre no to.co quando ele pedir, conforme descrito em Login.

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

## Login

As ferramentas de identidade e de ajuda não exigem login. As ferramentas de empresas e de locais funcionam nos negócios que pertencem à sua conta, então o assistente precisa agir como você. Há duas formas.

Entrar com o to.co (OAuth). Quando o assistente usa pela primeira vez a ferramenta de empresas ou de locais, o servidor responde que é preciso fazer login, e o assistente abre uma página do to.co em que você entra e vê o que ele está pedindo: ler seus negócios e alterar o perfil público deles. Você pode desmarcar as alterações. Ele então recebe um token que dura uma hora e se renova sozinho; você pode desconectá-lo a qualquer momento na página Login e segurança. Isso funciona em assistentes que oferecem login por MCP (OAuth).

Ou use um token de agente, para scripts e assistentes sem login por MCP. Crie um na página Login e segurança do my.to.co. Ele dura 90 dias, começa com toco_at_, pode fazer tudo o que as ferramentas de empresas e de locais fazem, e você pode revogá-lo lá. Envie-o como Authorization: Bearer toco_at_…. Trate-o como uma senha: tokens enviados de páginas web são recusados. Em qualquer caso, o servidor confere a propriedade em todas as chamadas: o negócio de outra conta aparece como não encontrado.

[Gerenciar apps conectados e tokens](https://my.to.co/account/security)

<a id="business"></a>
## O servidor próprio de cada negócio

Todo negócio publicado no to.co também tem o próprio servidor MCP, no próprio endereço com /mcp no final, por exemplo https://mybusiness.uk.to.co/mcp. É um servidor separado do mcp.to.co, com ferramentas próprias sobre aquele único negócio: o que ele publica na página (quem é, como entrar em contato, quando e onde está aberto e o que permite que os assistentes façam), mensagens, quando o negócio as aceita, e ferramentas para o proprietário. Nenhuma delas consulta outro negócio, e nenhuma recebe um endereço. Fazer perguntas sobre o negócio é grátis e não exige login. O servidor de cada negócio é documentado no próprio endereço, em /mcp/docs, no idioma de quem lê. A página do negócio tem um link para ele, e o llms.txt e um cabeçalho Link (rel="service-desc") apontam para o cartão do servidor, /.well-known/mcp.json.

Para conectar, adicione ao seu assistente o endereço do negócio, terminando em /mcp, como conector personalizado ou servidor MCP. O login funciona como descrito em Login, e a conexão vale só para aquele negócio: um token de outro negócio, ou do mcp.to.co, é recusado. O proprietário encontra o endereço no my.to.co, na aba Assistentes de IA do negócio.

Consultar um negócio não custa nada, com ou sem login: cada solicitante (um token, ou um endereço IP sem token) pode fazer 600 consultas por hora no servidor de cada negócio. Uma chamada que exige login é paga por quem a faz. A conta do proprietário usa os créditos mensais de API do negócio, em todos os planos. Qualquer outra pessoa tem uma franquia própria, válida para todos os negócios: 60 chamadas por hora e 500 por mês. Passadas as 500 do mês, um negócio que a própria conta da pessoa tem no to.co paga com os créditos mensais de API dele; sem isso, as chamadas são recusadas até o dia 1º. As recusas são HTTP 429: credits_exhausted quando o mês do negócio se esgotou, allowance_exhausted para o mês da pessoa e rate_limited com Retry-After para uma hora.

Nos planos Pro e Grow, o proprietário pode permitir que assistentes enviem uma mensagem ao negócio com a ferramenta messages, depois que a pessoa em nome de quem o assistente age a tiver visto e pedido o envio, com o próprio nome e os próprios dados de contato. Fica desativado até o proprietário ativar.

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

Toda conexão tem as quatro ferramentas abaixo; contas conectadas também recebem ferramentas para documentos, parceiros comerciais e mensagens. Cada uma recebe um argumento action que diz o que fazer, mais os argumentos de que essa ação precisa. Os nomes de campos de argumentos e resultados estão em snake_case, como na API do to.co. Todo resultado é JSON, devolvido como conteúdo estruturado com um esquema de saída correspondente. O horário de funcionamento mantém a forma em que é guardado: day (0 para domingo a 6 para sábado) ou date (YYYY-MM-DD), open, open_time e close_time no formato de 24 horas HH:mm; um horário de fechamento anterior ao de abertura passa da meia-noite.

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

Exemplo de chamada:

```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` (login, escopo `companies:read`, somente leitura): Every business the account owns, with its record key and publish status.
- `get` (login, escopo `companies:read`, somente leitura): One business the account owns, by record key.
  - `domain` (string, obrigatório): The record key of a company you own, as returned by companies list (the `domain` field)
- `update` (login, escopo `companies:write`, altera dados): 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, obrigatório): 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

Exemplo de chamada:

```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` (login, escopo `companies:read`, somente leitura): Every location of a business you own, with its record key, kind (registered or trading), hours, phones and profiles.
  - `domain` (string, obrigatório): The record key of a company you own, as returned by companies list (the `domain` field)
- `update` (login, escopo `companies:write`, altera dados): 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, obrigatório): The record key of a company you own, as returned by companies list (the `domain` field)
  - `location` (string, obrigatório): 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

Exemplo de chamada:

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

Exemplo de chamada:

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

## Erros

Uma chamada que o assistente consegue corrigir volta como resultado de ferramenta marcado como erro, começando com um código estável e dizendo o que mudar:

- `invalid_arguments`: Um argumento está faltando, fora do intervalo ou é desconhecido (os nomes de campos estão em snake_case), ou a ação é desconhecida.
- `not_found`: Nenhum negócio publicado corresponde, ou nenhum negócio ou local seu tem essa chave de registro.
- `unauthenticated`: A ação exige login (visto apenas com clientes que não reagem ao HTTP 401 abaixo).
- `insufficient_scope`: A conexão não tem permissão para essa ação, por exemplo uma alteração quando só a leitura foi permitida.

Uma chamada de companies ou locations sem login recebe HTTP 401 com um cabeçalho WWW-Authenticate que aponta para os metadados de recurso protegido do servidor; é assim que o assistente sabe que deve iniciar o login. Uma ação fora do que você permitiu recebe HTTP 403 com error=insufficient_scope e o escopo a pedir. Um token inválido, expirado ou revogado recebe HTTP 401 antes de qualquer ferramenta rodar; ele nunca é tratado como ausência de token. Solicitações demais recebem HTTP 429 com um cabeçalho Retry-After.

## Limites

- 120 solicitações por minuto por token de agente, ou por endereço IP sem token.
- Corpos de solicitação de até 1024 KB.
- A busca devolve até 25 negócios por chamada.

## Descoberta

- Cartão do servidor: https://mcp.to.co/.well-known/mcp.json
- Entrada no MCP Registry (co.to/mcp): https://mcp.to.co/server.json
- Metadados de recurso protegido (RFC 9728): https://mcp.to.co/.well-known/oauth-protected-resource
- Metadados do servidor de autorização (RFC 8414): https://my.to.co/.well-known/oauth-authorization-server

## Dados e privacidade

As consultas devolvem apenas registros publicados, os mesmos fatos da página pública do negócio. O servidor registra qual ferramenta e qual ação rodaram, se funcionaram e quanto tempo levaram, sem argumentos e sem conteúdo dos registros. Quando você conecta um assistente, o to.co guarda um registro da conexão (o nome do app, o que você permitiu, quando ela foi feita e usada pela última vez), que permanece como registro de segurança depois que você a desconecta.

## Próximos passos

- [Ler a publicação de lançamento](https://to.co/en-us/blog/mcp-server)
- [Começar](https://my.to.co/claim)
