Server MCP to.co
Umožněte asistentovi AI vyhledávat zveřejněné záznamy firem na to.co a udržovat aktuální profil vaší vlastní firmy. Vyhledávání firem je zdarma a nevyžaduje přihlášení.
Připojte svého asistenta Nástroje
- URL serveru
https://mcp.to.co/mcp- Přenos
- Streamable HTTP (revize protokolu MCP 2026-07-28, 2025-11-25)
Připojte svého asistenta
Přidejte URL serveru do svého asistenta. Vyhledávání funguje hned. Aby mohl spravovat vaše vlastní firmy, přihlaste se do to.co, až o to požádá, jak je popsáno v části Přihlášení.
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.
Přihlášení
Nástroje identity a nápovědy přihlášení nevyžadují. Nástroje společností a míst pracují s firmami, které vlastní váš účet, takže asistent musí jednat vaším jménem. Existují dva způsoby.
Přihlášení přes to.co (OAuth). Když asistent poprvé použije nástroj společností nebo míst, server odpoví, že je potřeba přihlášení, a asistent otevře stránku to.co, kde se přihlásíte a uvidíte, o co žádá: čtení vašich firem a změny jejich veřejného profilu. Změny můžete odškrtnout. Asistent pak dostane token, který platí hodinu a sám se obnovuje; kdykoli ho můžete odpojit na stránce Přihlášení a zabezpečení. Funguje to v asistentech, které podporují přihlášení MCP (OAuth).
Nebo použijte token agenta, pro skripty a asistenty bez přihlášení MCP. Vytvoříte ho na stránce Přihlášení a zabezpečení v my.to.co. Platí 90 dní, začíná na toco_at_, může dělat vše, co nástroje společností a míst, a tamtéž ho můžete zrušit. Posílejte ho jako Authorization: Bearer toco_at_…. Zacházejte s ním jako s heslem: tokeny z webových stránek se odmítají. V obou případech server při každém volání kontroluje vlastnictví: firma jiného účtu se jeví jako nenalezená.
Spravovat propojené aplikace a tokeny
Vlastní server každé firmy
Každá zveřejněná firma na to.co má také vlastní server MCP na své vlastní adrese s /mcp na konci, například https://mybusiness.uk.to.co/mcp. Je to samostatný server, oddělený od mcp.to.co, s vlastními nástroji o této jedné firmě: co zveřejňuje na své stránce (kdo je, jak ji kontaktovat, kdy a kde má otevřeno a co dovoluje asistentům), zprávy, pokud je firma přijímá, a nástroje pro jejího vlastníka. Žádný z nich nevyhledává jinou firmu a žádný nepřijímá adresu. Dotazy na firmu jsou zdarma a nevyžadují přihlášení. Server každé firmy je zdokumentován na její vlastní adrese, na /mcp/docs, v jazyce čtenáře. Stránka firmy na něj odkazuje a její llms.txt a hlavička Link (rel="service-desc") odkazují na kartu serveru, /.well-known/mcp.json.
Chcete-li se připojit, přidejte adresu firmy končící na /mcp do svého asistenta jako vlastní konektor nebo server MCP. Přihlášení funguje tak, jak je popsáno v části Přihlášení, a připojení platí jen pro tuto firmu: token pro jinou firmu nebo pro mcp.to.co je odmítnut. Vlastník najde adresu v my.to.co na kartě Asistenti AI dané firmy.
Vyhledání firmy nic nestojí, ať jste přihlášeni, nebo ne: každý volající (token, nebo bez něj IP adresa) smí na serveru každé firmy provést 600 vyhledání za hodinu. Volání, které vyžaduje přihlášení, platí ten, kdo ho provádí. Účet vlastníka čerpá měsíční kredity API firmy, v každém tarifu. Kdokoli jiný má vlastní limit napříč všemi firmami: 60 volání za hodinu a 500 za měsíc. Po vyčerpání měsíčního limitu 500 platí z měsíčních kreditů API firma, kterou má jeho vlastní účet na to.co; bez ní jsou volání až do 1. dne dalšího měsíce odmítána. Odmítnutí mají kód HTTP 429: credits_exhausted, když je měsíc firmy vyčerpán, allowance_exhausted pro měsíc dané osoby a rate_limited s Retry-After pro hodinový limit.
V tarifech Pro a Grow může vlastník dovolit asistentům poslat firmě zprávu nástrojem messages, jakmile ji osoba, za kterou asistent jedná, uvidí a požádá o její odeslání, s vlastním jménem a kontaktními údaji. Dokud to vlastník nezapne, je to vypnuté.
Nástroje
Každé připojení má čtyři nástroje uvedené níže; přihlášené účty dostanou také nástroje pro doklady, obchodní partnery a zprávy. Každý přijímá argument action, který říká, co se má udělat, a k tomu argumenty, které daná akce potřebuje. Názvy polí argumentů a výsledků jsou ve snake_case, stejně jako v API to.co. Každý výsledek je JSON, vrácený jako strukturovaný obsah s odpovídajícím výstupním schématem. Otevírací doba zůstává v uložené podobě: day (0 pro neděli až 6 pro sobotu) nebo date (YYYY-MM-DD), open, open_time a close_time ve 24hodinovém formátu HH:mm; čas zavření dřívější než čas otevření znamená otevřeno přes půlnoc.
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.
| Akce | Co dělá | Argumenty | Přístup |
|---|---|---|---|
resolve | The business at a to.co address. |
| Kdokoli Jen pro čtení |
website | The businesses whose website is on this hostname. A website can belong to more than one business, so this returns a list. |
| Kdokoli Jen pro čtení |
search | Businesses whose name matches, newest first. |
| Kdokoli Jen pro čtení |
Příklad volání
{
"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.
| Akce | Co dělá | Argumenty | Přístup |
|---|---|---|---|
list | Every business the account owns, with its record key and publish status. | Žádné | Přihlášení, rozsah companies:readJen pro čtení |
get | One business the account owns, by record key. |
| Přihlášení, rozsah companies:readJen pro čtení |
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. |
| Přihlášení, rozsah companies:writeMění data |
Příklad volání
{
"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.
| Akce | Co dělá | Argumenty | Přístup |
|---|---|---|---|
list | Every location of a business you own, with its record key, kind (registered or trading), hours, phones and profiles. |
| Přihlášení, rozsah companies:readJen pro čtení |
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. |
| Přihlášení, rozsah companies:writeMění data |
Příklad volání
{
"name": "locations",
"arguments": {
"action": "list",
"domain": "yxpx6pdx.uk.to.co"
}
}
help — Connection and usage help
Check this connection and read the usage guide.
| Akce | Co dělá | Argumenty | Přístup |
|---|---|---|---|
whoami | Whether this connection is signed in, and which tools and actions it can use. | Žádné | Kdokoli Jen pro čtení |
guide | The usage guide as Markdown (also the resource toco://guide). | Žádné | Kdokoli Jen pro čtení |
Příklad volání
{
"name": "help",
"arguments": {
"action": "whoami"
}
}
Zdroje
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
Výzvy
look_up_business— Find a business on to.co by its to.co address, website or name, and summarize its record. Argumenty:business.review_my_profile— Read a business you own and suggest clearer wording for its public profile. Changes nothing until you confirm. Argumenty:domain.
Chyby
Volání, které může asistent opravit, se vrátí jako výsledek nástroje označený jako chyba, začínající stálým kódem a s popisem, co změnit:
invalid_arguments— Argument chybí, je mimo rozsah nebo je neznámý (názvy polí jsou ve snake_case), nebo je akce neznámá.not_found— Neodpovídá žádná zveřejněná firma, nebo žádná vaše firma ani místo nemá tento klíč záznamu.unauthenticated— Akce vyžaduje přihlášení (objevuje se jen u klientů, kteří nereagují na níže uvedený HTTP 401).insufficient_scope— Připojení nemělo pro tuto akci povolení, například pro změnu, když bylo povoleno jen čtení.
Volání companies nebo locations bez přihlášení dostane HTTP 401 s hlavičkou WWW-Authenticate odkazující na metadata chráněného zdroje serveru; podle toho asistent pozná, že má zahájit přihlášení. Akce mimo to, co jste povolili, dostane HTTP 403 s error=insufficient_scope a rozsahem, o který je třeba požádat. Neplatný, prošlý nebo zrušený token dostane HTTP 401 dřív, než se spustí jakýkoli nástroj; nikdy se s ním nezachází jako s chybějícím tokenem. Příliš mnoho požadavků dostane HTTP 429 s hlavičkou Retry-After.
Limity
- 120 požadavků za minutu na token agenta, nebo bez něj na IP adresu.
- Těla požadavků do 1024 KB.
- Hledání vrátí nejvýše 25 firem na jedno volání.
Vyhledání serveru
- Karta serveru —
https://mcp.to.co/.well-known/mcp.json - Záznam v MCP Registry (co.to/mcp) —
https://mcp.to.co/server.json - Metadata chráněného zdroje (RFC 9728) —
https://mcp.to.co/.well-known/oauth-protected-resource - Metadata autorizačního serveru (RFC 8414) —
https://my.to.co/.well-known/oauth-authorization-server - llms.txt pro tento web
Data a ochrana soukromí
Vyhledávání vrací jen zveřejněné záznamy, tytéž údaje jako veřejná stránka firmy. Server zaznamenává, který nástroj a akce proběhly, zda uspěly a jak dlouho trvaly, bez argumentů a bez obsahu záznamů. Když připojíte asistenta, to.co si uchová záznam o připojení (název aplikace, co jste povolili, kdy bylo vytvořeno a naposledy použito), který zůstane jako bezpečnostní záznam i po odpojení.