**MCP server** · [API](https://to.co/et-ee/docs/api?format=md)

# to.co MCP server

Laske AI-assistendil otsida to.co-s avaldatud ettevõtete kirjeid ja hoida oma ettevõtte profiil ajakohasena. Ettevõtete otsimine on tasuta ega nõua sisselogimist.

[Ühendage oma assistent](#connect) · [Tööriistad](#tools)

- Serveri URL: `https://mcp.to.co/mcp`
- Transport: Streamable HTTP (MCP protokolli versioonid 2026-07-28, 2025-11-25)

<a id="connect"></a>
## Ühendage oma assistent

Lisage serveri URL oma assistendile. Otsingud toimivad kohe. Et lubada tal hallata teie enda ettevõtteid, logige küsimisel to.co-sse sisse, nagu on kirjeldatud jaotises Sisselogimine.

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

## Sisselogimine

Identiteedi- ja abitööriistad ei nõua sisselogimist. Ettevõtete ja asukohtade tööriistad töötavad teie konto omanduses olevate ettevõtetega, seega peab assistent tegutsema teie nimel. Selleks on kaks võimalust.

Logige sisse to.co-ga (OAuth). Kui assistent kasutab esimest korda ettevõtete või asukohtade tööriista, vastab server, et on vaja sisse logida, ja assistent avab to.co lehe, kus logite sisse ja näete, mida see küsib: teie ettevõtete lugemist ja nende avaliku profiili muutmist. Muutmise linnukese saate eemaldada. Seejärel saab assistent tõendi (token), mis kehtib tund aega ja uueneb ise; ühenduse saate igal ajal katkestada lehel Sisselogimine ja turvalisus. See toimib assistentides, mis toetavad MCP sisselogimist (OAuth).

Või kasutage agendi tõendit (token) skriptide ja assistentide jaoks, millel MCP sisselogimist pole. Looge see my.to.co lehel Sisselogimine ja turvalisus. See kehtib 90 päeva, algab eesliitega toco_at_, saab teha kõike, mida ettevõtete ja asukohtade tööriistad teevad, ja saate selle seal tühistada. Saatke see kujul Authorization: Bearer toco_at_…. Käsitlege seda nagu parooli: veebilehtedelt tulevad tõendid lükatakse tagasi. Mõlemal juhul kontrollib server igal päringul omandiõigust: teise konto ettevõte ei ole leitav.

[Halda ühendatud rakendusi ja tõendeid](https://my.to.co/account/security)

<a id="business"></a>
## Iga ettevõtte oma server

Igal to.co-s avaldatud ettevõttel on ka oma MCP-server, mis asub tema enda aadressil, mille lõpus on /mcp, näiteks https://mybusiness.uk.to.co/mcp. See on mcp.to.co-st eraldi server, millel on selle ühe ettevõtte kohta oma tööriistad: mida ettevõte oma lehel avaldab (kes ta on, kuidas temaga ühendust võtta, millal ja kus ta on avatud ning mida ta assistentidel teha lubab), sõnumid, kui ettevõte neid vastu võtab, ja tööriistad selle omanikule. Ükski neist ei otsi teisi ettevõtteid ega võta vastu aadressi. Ettevõtte kohta küsimine on tasuta ega nõua sisselogimist. Iga ettevõtte serveri dokumentatsioon on tema enda aadressil, lehel /mcp/docs, lugeja keeles. Ettevõtte leht viitab sellele ning tema llms.txt ja Link-päis (rel="service-desc") viitavad tema serverikaardile /.well-known/mcp.json.

Ühendamiseks lisage ettevõtte aadress, mille lõpus on /mcp, oma assistendile kohandatud konnektori või MCP-serverina. Sisselogimine toimub nii, nagu on kirjeldatud jaotises „Sisselogimine“, ja ühendus kehtib ainult selle ettevõtte kohta: teise ettevõtte või mcp.to.co tõend lükatakse tagasi. Omanik leiab aadressi my.to.co-s ettevõtte vahekaardilt „AI-assistendid“.

Ettevõtte otsimine on tasuta, nii sisselogituna kui ka ilma: iga pöörduja (tõend või ilma selleta IP-aadress) võib teha iga ettevõtte serverile 600 päringut tunnis. Sisselogimist nõudva päringu eest maksab selle tegija. Omaniku konto kasutab ettevõtte igakuiseid API-krediite igas paketis. Kõigil teistel on kõigi ettevõtete peale oma limiit: 60 päringut tunnis ja 500 kuus. Kui kuu 500 on täis, maksab ettevõte, mis on tema enda kontol to.co-s, oma igakuistest API-krediitidest; ilma selleta lükatakse päringud kuni kuu 1. kuupäevani tagasi. Tagasilükkamised on HTTP 429: credits_exhausted, kui ettevõtte kuu limiit on täis, allowance_exhausted isiku kuu limiidi korral ja rate_limited koos päisega Retry-After tunnilimiidi korral.

Pro- ja Grow-paketis saab omanik lubada assistentidel saata ettevõttele sõnumi tööriistaga messages, kui isik, kelle nimel assistent tegutseb, on sõnumit näinud ja palunud selle saata, koos oma nime ja kontaktandmetega. See on välja lülitatud, kuni omanik selle sisse lülitab.

<a id="tools"></a>
## Tööriistad

Igal ühendusel on allpool olevad neli tööriista; sisselogitud kontod saavad lisaks tööriistad dokumentide, äripartnerite ja sõnumite jaoks. Igaüks võtab argumendi action, mis ütleb, mida teha, ning argumendid, mida see toiming vajab. Argumentide ja tulemuste väljade nimed on snake_case-kujul nagu to.co API-s. Iga tulemus on JSON, mis tagastatakse struktureeritud sisuna koos vastava väljundskeemiga. Lahtiolekuajad säilitavad salvestatud kuju: day (0 pühapäev kuni 6 laupäev) või date (YYYY-MM-DD), open, open_time ja close_time 24-tunnises vormingus HH:mm; kui sulgemisaeg on varasem kui avamisaeg, kestab aeg üle südaöö.

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

Näidispäring:

```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` (sisselogimine, ulatus `companies:read`, ainult lugemine): Every business the account owns, with its record key and publish status.
- `get` (sisselogimine, ulatus `companies:read`, ainult lugemine): One business the account owns, by record key.
  - `domain` (string, kohustuslik): The record key of a company you own, as returned by companies list (the `domain` field)
- `update` (sisselogimine, ulatus `companies:write`, muudab andmeid): 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, kohustuslik): 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

Näidispäring:

```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` (sisselogimine, ulatus `companies:read`, ainult lugemine): Every location of a business you own, with its record key, kind (registered or trading), hours, phones and profiles.
  - `domain` (string, kohustuslik): The record key of a company you own, as returned by companies list (the `domain` field)
- `update` (sisselogimine, ulatus `companies:write`, muudab andmeid): 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, kohustuslik): The record key of a company you own, as returned by companies list (the `domain` field)
  - `location` (string, kohustuslik): 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

Näidispäring:

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

Näidispäring:

```json
{
  "name": "help",
  "arguments": {
    "action": "whoami"
  }
}
```

## Ressursid

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

## Viibad

- `look_up_business`: Find a business on to.co by its to.co address, website or name, and summarize its record. Argumendid: `business`.
- `review_my_profile`: Read a business you own and suggest clearer wording for its public profile. Changes nothing until you confirm. Argumendid: `domain`.

## Vead

Päring, mida assistent saab parandada, tuleb tagasi veaks märgitud tööriista tulemusena, mis algab püsiva koodiga ja ütleb, mida muuta:

- `invalid_arguments`: Argument puudub, on lubatud vahemikust väljas või tundmatu (väljade nimed on snake_case-kujul) või on toiming tundmatu.
- `not_found`: Ükski avaldatud ettevõte ei vasta päringule või ühelgi teie ettevõttel ega asukohal pole selle kirje võtit.
- `unauthenticated`: Toiming nõuab sisselogimist (ilmneb ainult klientidega, kes ei reageeri allpool kirjeldatud HTTP 401-le).
- `insufficient_scope`: Ühendusele ei antud selleks toiminguks luba, näiteks muudatuseks, kui lubatud oli ainult lugemine.

Ilma sisselogimiseta companies- või locations-päring saab vastuseks HTTP 401 koos päisega WWW-Authenticate, mis viitab serveri kaitstud ressursi metaandmetele; nii teab assistent, et tuleb alustada sisselogimist. Toiming, mis jääb väljapoole teie antud lubasid, saab vastuseks HTTP 403 koos väärtusega error=insufficient_scope ja ulatusega, mida küsida. Kehtetu, aegunud või tühistatud tõend saab vastuseks HTTP 401 enne, kui ükski tööriist käivitub; seda ei käsitleta kunagi kui tõendi puudumist. Liiga paljud päringud saavad vastuseks HTTP 429 koos päisega Retry-After.

## Piirangud

- 120 päringut minutis agendi tõendi kohta või ilma selleta IP-aadressi kohta.
- Päringu sisu kuni 1024 KB.
- Otsing tagastab päringu kohta kuni 25 ettevõtet.

## Avastamine

- Serverikaart: https://mcp.to.co/.well-known/mcp.json
- MCP Registry kirje (co.to/mcp): https://mcp.to.co/server.json
- Kaitstud ressursi metaandmed (RFC 9728): https://mcp.to.co/.well-known/oauth-protected-resource
- Autoriseerimisserveri metaandmed (RFC 8414): https://my.to.co/.well-known/oauth-authorization-server

## Andmed ja privaatsus

Otsingud tagastavad ainult avaldatud kirjeid, samu andmeid mis ettevõtte avalikul lehel. Server logib, milline tööriist ja toiming käivitati, kas see õnnestus ja kui kaua see aega võttis, ilma argumentide ja kirjete sisuta. Kui ühendate assistendi, säilitab to.co ühenduse kohta kirje (rakenduse nimi, mida te lubasite, millal see loodi ja viimati kasutati), mis jääb pärast ühenduse katkestamist alles turvakirjena.

## Järgmised sammud

- [Lugege käivitamise postitust](https://to.co/en-us/blog/mcp-server)
- [Alusta](https://my.to.co/claim)
