to.co-etusivu

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 Työkalut

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

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.
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.
{
  "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.
{
  "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.
{
  "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

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.

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.

ToimintoMitä se tekeeArgumentitKäyttöoikeus
resolveThe 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
Kaikki
Vain luku
websiteThe 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/
Kaikki
Vain luku
searchBusinesses 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)
Kaikki
Vain luku

Esimerkkikutsu

{
  "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.

ToimintoMitä se tekeeArgumentitKäyttöoikeus
listEvery business the account owns, with its record key and publish status.Ei mitäänKirjautuminen, oikeus companies:read
Vain luku
getOne 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)
Kirjautuminen, oikeus companies:read
Vain luku
updateChange 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
Kirjautuminen, oikeus companies:write
Muuttaa tietoja

Esimerkkikutsu

{
  "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.

ToimintoMitä se tekeeArgumentitKäyttöoikeus
listEvery 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)
Kirjautuminen, oikeus companies:read
Vain luku
updateSet 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
Kirjautuminen, oikeus companies:write
Muuttaa tietoja

Esimerkkikutsu

{
  "name": "locations",
  "arguments": {
    "action": "list",
    "domain": "yxpx6pdx.uk.to.co"
  }
}

help — Connection and usage help

Check this connection and read the usage guide.

ToimintoMitä se tekeeArgumentitKäyttöoikeus
whoamiWhether this connection is signed in, and which tools and actions it can use.Ei mitäänKaikki
Vain luku
guideThe usage guide as Markdown (also the resource toco://guide).Ei mitäänKaikki
Vain luku

Esimerkkikutsu

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

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

Kieli

Valitse kielistä, joita sivusto ja sovellus tukevat kokonaan.