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

# to.co:n MCP-palvelin

Anna tekoälyavustajan hakea julkaistuja yritystietoja to.co:ssa ja pitää oman yrityksen profiili ajan tasalla. Yritysten hakeminen on maksutonta eikä vaadi kirjautumista.

[Yhdistä avustaja](#connect) · [Työkalut](#tools)

- Palvelimen URL: `https://mcp.to.co/mcp`
- Siirtotapa: Streamable HTTP (MCP-protokollan versiot 2026-07-28, 2025-11-25)

<a id="connect"></a>
## Yhdistä avustaja

Lisää palvelimen URL avustajaan. Haut toimivat heti. Jotta avustaja voi hallinnoida omia yrityksiä, kirjaudu to.co:hon, kun se pyytää, kuten kohdassa Kirjautuminen kuvataan.

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

## Kirjautuminen

Identity- ja help-työkalut eivät vaadi kirjautumista. Companies- ja locations-työkalut käsittelevät tilin omistamia yrityksiä, joten avustajan on toimittava puolestasi. Tähän on kaksi tapaa.

Kirjaudu to.co-tunnuksilla (OAuth). Kun avustaja käyttää companies- tai locations-työkalua ensimmäisen kerran, palvelin vastaa vaativansa kirjautumisen, ja avustaja avaa to.co-sivun, jolla kirjaudut ja näet, mitä se pyytää: yritysten tietojen lukemista ja niiden julkisen profiilin muuttamista. Muutosoikeuden valinnan voi poistaa. Avustaja saa sitten tunnuksen (token), joka on voimassa tunnin ja uusiutuu itsestään; yhteyden voi katkaista milloin tahansa Kirjautuminen ja tietoturva -sivulla. Tämä toimii avustajissa, jotka tukevat MCP-kirjautumista (OAuth).

Tai käytä agenttitunnusta skripteille ja avustajille, joissa ei ole MCP-kirjautumista. Luo tunnus my.to.co:n Kirjautuminen ja tietoturva -sivulla. Se on voimassa 90 päivää, alkaa merkkijonolla toco_at_, voi tehdä kaiken, mitä companies- ja locations-työkalut tekevät, ja sen voi peruuttaa samalla sivulla. Lähetä se muodossa Authorization: Bearer toco_at_…. Käsittele sitä kuin salasanaa: verkkosivuilta lähetetyt tunnukset hylätään. Kummassakin tapauksessa palvelin tarkistaa omistajuuden jokaisessa kutsussa: toisen tilin yritys näkyy kuin sitä ei löytyisi.

[Hallitse yhdistettyjä sovelluksia ja tunnuksia](https://my.to.co/account/security)

<a id="business"></a>
## Jokaisen yrityksen oma palvelin

Jokaisella to.co-palvelussa julkaistulla yrityksellä on myös oma MCP-palvelin omassa osoitteessaan, jonka loppuun on lisätty /mcp, esimerkiksi https://mybusiness.uk.to.co/mcp. Se on eri palvelin kuin mcp.to.co, ja sillä on omat työkalunsa juuri tästä yhdestä yrityksestä: mitä yritys julkaisee sivullaan (kuka se on, miten sen tavoittaa, milloin ja missä se on avoinna ja mitä se sallii avustajien tehdä), viestit, jos yritys ottaa niitä vastaan, sekä työkalut omistajalle. Mikään niistä ei hae toista yritystä, eikä mikään ota vastaan osoitetta. Yrityksestä kysyminen on maksutonta eikä vaadi kirjautumista. Kunkin yrityksen palvelin on dokumentoitu sen omassa osoitteessa polussa /mcp/docs lukijan kielellä. Yrityssivu linkittää siihen, ja sen llms.txt sekä Link-otsake (rel="service-desc") osoittavat palvelimen korttiin /.well-known/mcp.json.

Yhdistä lisäämällä yrityksen osoite, joka päättyy /mcp, avustajaan mukautettuna liittimenä tai MCP-palvelimena. Kirjautuminen toimii kohdassa Kirjautuminen kuvatulla tavalla, ja yhteys koskee vain tätä yritystä: toisen yrityksen tai mcp.to.co-palvelun tunnus hylätään. Omistaja löytää osoitteen my.to.co-palvelusta yrityksen Tekoälyavustajat-välilehdeltä.

Yrityksen hakeminen on maksutonta kirjautuneena tai ilman: kukin kutsuja (tunnus tai ilman tunnusta IP-osoite) voi tehdä 600 hakua tunnissa kunkin yrityksen palvelimelle. Kirjautumista vaativan kutsun maksaa sen tekijä. Omistajan tili käyttää yrityksen kuukausittaisia API-krediittejä kaikissa paketeissa. Kaikilla muilla on oma kiintiönsä kaikkiin yrityksiin yhteensä: 60 kutsua tunnissa ja 500 kuukaudessa. Kun kuukauden 500 kutsua on käytetty, kutsut maksetaan sen yrityksen kuukausittaisista API-krediiteistä, joka henkilön omalla tilillä on to.co-palvelussa; ilman sellaista kutsut hylätään kuun 1. päivään asti. Hylkäykset ovat HTTP 429: credits_exhausted, kun yrityksen kuukausi on käytetty, allowance_exhausted henkilön kuukaudelle ja rate_limited ja Retry-After tunnin rajalle.

Pro- ja Grow-paketeissa omistaja voi sallia avustajien lähettää yritykselle viestin messages-työkalulla, kun henkilö, jonka puolesta avustaja toimii, on nähnyt viestin ja pyytänyt sen lähettämistä omalla nimellään ja yhteystiedoillaan. Toiminto on pois päältä, kunnes omistaja ottaa sen käyttöön.

<a id="tools"></a>
## Työkalut

Jokaisessa yhteydessä on alla olevat neljä työkalua; sisäänkirjautuneet tilit saavat lisäksi työkalut asiakirjoille, kauppakumppaneille ja viesteille. Kukin ottaa action-argumentin, joka kertoo, mitä tehdään, sekä toiminnon tarvitsemat argumentit. Argumenttien ja tulosten kenttien nimet ovat snake_case-muodossa kuten to.co API:ssa. Jokainen tulos on JSONia, ja se palautetaan rakenteisena sisältönä vastaavan tulosskeeman kanssa. Aukioloajat säilyttävät tallennetun muotonsa: day (0 sunnuntaista 6 lauantaihin) tai date (YYYY-MM-DD), open, open_time ja close_time 24 tunnin muodossa HH:mm; jos sulkemisaika on aikaisempi kuin avaamisaika, aukioloaika jatkuu yli keskiyön.

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

Esimerkkikutsu:

```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` (kirjautuminen, oikeus `companies:read`, vain luku): Every business the account owns, with its record key and publish status.
- `get` (kirjautuminen, oikeus `companies:read`, vain luku): One business the account owns, by record key.
  - `domain` (string, pakollinen): The record key of a company you own, as returned by companies list (the `domain` field)
- `update` (kirjautuminen, oikeus `companies:write`, muuttaa tietoja): 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, pakollinen): 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

Esimerkkikutsu:

```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` (kirjautuminen, oikeus `companies:read`, vain luku): Every location of a business you own, with its record key, kind (registered or trading), hours, phones and profiles.
  - `domain` (string, pakollinen): The record key of a company you own, as returned by companies list (the `domain` field)
- `update` (kirjautuminen, oikeus `companies:write`, muuttaa tietoja): 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, pakollinen): The record key of a company you own, as returned by companies list (the `domain` field)
  - `location` (string, pakollinen): 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

Esimerkkikutsu:

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

Esimerkkikutsu:

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

## Resurssit

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

## Kehotteet

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

## Virheet

Kutsu, jonka avustaja voi korjata, palautuu virheeksi merkittynä työkalun tuloksena. Se alkaa pysyvällä koodilla ja kertoo, mitä pitää muuttaa:

- `invalid_arguments`: Argumentti puuttuu, on sallitun alueen ulkopuolella tai on tuntematon (kenttien nimet ovat snake_case-muodossa), tai toiminto on tuntematon.
- `not_found`: Mikään julkaistu yritys ei vastaa hakua, tai millään omistamallasi yrityksellä tai sijainnilla ei ole tätä tietueavainta.
- `unauthenticated`: Toiminto vaatii kirjautumisen (näkyy vain asiakkaissa, jotka eivät reagoi alla kuvattuun HTTP 401 -vastaukseen).
- `insufficient_scope`: Yhteydelle ei ole sallittu tätä toimintoa, esimerkiksi muutosta, kun vain lukeminen on sallittu.

Ilman kirjautumista tehty companies- tai locations-kutsu saa vastauksen HTTP 401 ja WWW-Authenticate-otsakkeen, joka osoittaa palvelimen suojatun resurssin metatietoihin; tästä avustaja tietää aloittaa kirjautumisen. Toiminto, jota ei ole sallittu, saa vastauksen HTTP 403, jossa on error=insufficient_scope ja pyydettävä oikeus. Virheellinen, vanhentunut tai peruttu tunnus saa vastauksen HTTP 401 ennen kuin mikään työkalu suoritetaan; sitä ei koskaan käsitellä kuin tunnusta ei olisi. Liian monet pyynnöt saavat vastauksen HTTP 429 ja Retry-After-otsakkeen.

## Rajat

- 120 pyyntöä minuutissa agenttitunnusta kohden tai ilman tunnusta IP-osoitetta kohden.
- Pyyntöjen runko enintään 1024 kt.
- Haku palauttaa enintään 25 yritystä kutsua kohden.

## Löydettävyys

- Palvelimen kortti: https://mcp.to.co/.well-known/mcp.json
- MCP Registry -merkintä (co.to/mcp): https://mcp.to.co/server.json
- Suojatun resurssin metatiedot (RFC 9728): https://mcp.to.co/.well-known/oauth-protected-resource
- Valtuutuspalvelimen metatiedot (RFC 8414): https://my.to.co/.well-known/oauth-authorization-server

## Tiedot ja tietosuoja

Haut palauttavat vain julkaistuja tietoja, samat tiedot kuin yrityksen julkisella sivulla. Palvelin kirjaa lokiin, mikä työkalu ja toiminto suoritettiin, onnistuiko se ja kauanko se kesti, ilman argumentteja ja ilman tietueen sisältöä. Kun avustaja yhdistetään, to.co säilyttää tiedon yhteydestä (sovelluksen nimi, mitä sallittiin, milloin yhteys luotiin ja milloin sitä viimeksi käytettiin), ja tieto säilyy tietoturvakirjauksena myös yhteyden katkaisemisen jälkeen.

## Seuraavat vaiheet

- [Lue julkaisutiedote](https://to.co/en-us/blog/mcp-server)
- [Aloita](https://my.to.co/claim)
