Página inicial do to.co
Começar

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 Ferramentas

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

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

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.

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.

AçãoO que fazArgumentosAcesso
resolveThe 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
Qualquer pessoa
Somente leitura
websiteThe 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/
Qualquer pessoa
Somente leitura
searchBusinesses 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)
Qualquer pessoa
Somente leitura

Exemplo de chamada

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

AçãoO que fazArgumentosAcesso
listEvery business the account owns, with its record key and publish status.NenhumLogin, escopo companies:read
Somente leitura
getOne 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)
Login, escopo companies:read
Somente leitura
updateChange 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
Login, escopo companies:write
Altera dados

Exemplo de chamada

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

AçãoO que fazArgumentosAcesso
listEvery 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)
Login, escopo companies:read
Somente leitura
updateSet 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
Login, escopo companies:write
Altera dados

Exemplo de chamada

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

help — Connection and usage help

Check this connection and read the usage guide.

AçãoO que fazArgumentosAcesso
whoamiWhether this connection is signed in, and which tools and actions it can use.NenhumQualquer pessoa
Somente leitura
guideThe usage guide as Markdown (also the resource toco://guide).NenhumQualquer pessoa
Somente leitura

Exemplo de chamada

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

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

Idioma

Escolha entre os idiomas que o site e o aplicativo oferecem por completo.