**Server MCP** · [API](https://to.co/cs-cz/docs/api?format=md)

# 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](#connect) · [Nástroje](#tools)

- URL serveru: `https://mcp.to.co/mcp`
- Přenos: Streamable HTTP (revize protokolu MCP 2026-07-28, 2025-11-25)

<a id="connect"></a>
## 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)

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.

## 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](https://my.to.co/account/security)

<a id="business"></a>
## 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é.

<a id="tools"></a>
## 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.

- `resolve` (kdokoli, jen pro čtení): The business at a to.co address.
  - `host` (string, povinné): A to.co address, e.g. mybusiness.uk.to.co or mybusiness-bristol.biz.to.co
- `website` (kdokoli, jen pro čtení): The businesses whose website is on this hostname. A website can belong to more than one business, so this returns a list.
  - `website` (string, povinné): The business's own website, e.g. mybusiness.com or https://www.mybusiness.com/
- `search` (kdokoli, jen pro čtení): Businesses whose name matches, newest first.
  - `query` (string, povinné): Part of the business name, at least 2 characters
  - `limit` (integer): Maximum results, 1-25 (default 10)

Příklad volání:

```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` (přihlášení, rozsah `companies:read`, jen pro čtení): Every business the account owns, with its record key and publish status.
- `get` (přihlášení, rozsah `companies:read`, jen pro čtení): One business the account owns, by record key.
  - `domain` (string, povinné): The record key of a company you own, as returned by companies list (the `domain` field)
- `update` (přihlášení, rozsah `companies:write`, mění data): 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, povinné): 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

Příklad volání:

```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` (přihlášení, rozsah `companies:read`, jen pro čtení): Every location of a business you own, with its record key, kind (registered or trading), hours, phones and profiles.
  - `domain` (string, povinné): The record key of a company you own, as returned by companies list (the `domain` field)
- `update` (přihlášení, rozsah `companies:write`, mění data): 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, povinné): The record key of a company you own, as returned by companies list (the `domain` field)
  - `location` (string, povinné): 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

Příklad volání:

```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` (kdokoli, jen pro čtení): Whether this connection is signed in, and which tools and actions it can use.
- `guide` (kdokoli, jen pro čtení): The usage guide as Markdown (also the resource toco://guide).

Příklad volání:

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

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

## Další kroky

- [Přečtěte si článek o spuštění](https://to.co/en-us/blog/mcp-server)
- [Začít](https://my.to.co/claim)
