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.
- 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)
- 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.
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.
| Toiminto | Mitä se tekee | Argumentit | Käyttöoikeus |
|---|---|---|---|
resolve | The business at a to.co address. |
| Kaikki Vain luku |
website | The businesses whose website is on this hostname. A website can belong to more than one business, so this returns a list. |
| Kaikki Vain luku |
search | Businesses whose name matches, newest first. |
| 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.
| Toiminto | Mitä se tekee | Argumentit | Käyttöoikeus |
|---|---|---|---|
list | Every business the account owns, with its record key and publish status. | Ei mitään | Kirjautuminen, oikeus companies:readVain luku |
get | One business the account owns, by record key. |
| Kirjautuminen, oikeus companies:readVain luku |
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. |
| Kirjautuminen, oikeus companies:writeMuuttaa 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.
| Toiminto | Mitä se tekee | Argumentit | Käyttöoikeus |
|---|---|---|---|
list | Every location of a business you own, with its record key, kind (registered or trading), hours, phones and profiles. |
| Kirjautuminen, oikeus companies:readVain luku |
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. |
| Kirjautuminen, oikeus companies:writeMuuttaa 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.
| Toiminto | Mitä se tekee | Argumentit | Käyttöoikeus |
|---|---|---|---|
whoami | Whether this connection is signed in, and which tools and actions it can use. | Ei mitään | Kaikki Vain luku |
guide | The usage guide as Markdown (also the resource toco://guide). | Ei mitään | Kaikki 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
- 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 - Tämän sivuston llms.txt
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.