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)
- 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.
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ção | O que faz | Argumentos | Acesso |
|---|---|---|---|
resolve | The business at a to.co address. |
| Qualquer pessoa Somente leitura |
website | The businesses whose website is on this hostname. A website can belong to more than one business, so this returns a list. |
| Qualquer pessoa Somente leitura |
search | Businesses whose name matches, newest first. |
| 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ção | O que faz | Argumentos | Acesso |
|---|---|---|---|
list | Every business the account owns, with its record key and publish status. | Nenhum | Login, escopo companies:readSomente leitura |
get | One business the account owns, by record key. |
| Login, escopo companies:readSomente leitura |
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. |
| Login, escopo companies:writeAltera 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ção | O que faz | Argumentos | Acesso |
|---|---|---|---|
list | Every location of a business you own, with its record key, kind (registered or trading), hours, phones and profiles. |
| Login, escopo companies:readSomente leitura |
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. |
| Login, escopo companies:writeAltera 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ção | O que faz | Argumentos | Acesso |
|---|---|---|---|
whoami | Whether this connection is signed in, and which tools and actions it can use. | Nenhum | Qualquer pessoa Somente leitura |
guide | The usage guide as Markdown (also the resource toco://guide). | Nenhum | Qualquer 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
- 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 - llms.txt deste site
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.