Αρχική σελίδα του to.co

Ο διακομιστής MCP του to.co

Αφήστε έναν βοηθό AI να αναζητά δημοσιευμένες καταχωρίσεις επιχειρήσεων στο to.co και να κρατά ενημερωμένο το δικό σας προφίλ επιχείρησης. Η αναζήτηση επιχειρήσεων είναι δωρεάν και δεν απαιτεί σύνδεση.

Συνδέστε τον βοηθό σας Εργαλεία

URL διακομιστή
https://mcp.to.co/mcp
Μεταφορά
Streamable HTTP (αναθεωρήσεις πρωτοκόλλου MCP 2026-07-28, 2025-11-25)

Συνδέστε τον βοηθό σας

Προσθέστε το URL του διακομιστή στον βοηθό σας. Οι αναζητήσεις λειτουργούν αμέσως. Για να του επιτρέψετε να διαχειρίζεται τις δικές σας επιχειρήσεις, συνδεθείτε στο to.co όταν το ζητήσει, όπως περιγράφεται στην ενότητα Σύνδεση.

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.

Σύνδεση

Τα εργαλεία ταυτότητας και βοήθειας δεν απαιτούν σύνδεση. Τα εργαλεία εταιρειών και τοποθεσιών λειτουργούν στις επιχειρήσεις που ανήκουν στον λογαριασμό σας, οπότε ο βοηθός πρέπει να ενεργεί ως εσείς. Υπάρχουν δύο τρόποι.

Σύνδεση με το to.co (OAuth). Όταν ο βοηθός χρησιμοποιήσει για πρώτη φορά το εργαλείο εταιρειών ή τοποθεσιών, ο διακομιστής απαντά ότι χρειάζεται σύνδεση και ο βοηθός ανοίγει μια σελίδα του to.co όπου συνδέεστε και βλέπετε τι ζητά: την ανάγνωση των επιχειρήσεών σας και την αλλαγή του δημόσιου προφίλ τους. Μπορείτε να αποεπιλέξετε τις αλλαγές. Στη συνέχεια λαμβάνει ένα token που διαρκεί μία ώρα και ανανεώνεται μόνο του· μπορείτε να το αποσυνδέσετε οποτεδήποτε στη σελίδα Σύνδεση και ασφάλεια. Αυτό λειτουργεί σε βοηθούς που υποστηρίζουν σύνδεση MCP (OAuth).

Ή χρησιμοποιήστε ένα token πράκτορα, για scripts και βοηθούς χωρίς σύνδεση MCP. Δημιουργήστε ένα στη σελίδα Σύνδεση και ασφάλεια στο my.to.co. Διαρκεί 90 ημέρες, αρχίζει με toco_at_, μπορεί να κάνει ό,τι κάνουν τα εργαλεία εταιρειών και τοποθεσιών και μπορείτε να το ανακαλέσετε εκεί. Στείλτε το ως Authorization: Bearer toco_at_…. Αντιμετωπίστε το σαν κωδικό πρόσβασης: τα tokens απορρίπτονται όταν προέρχονται από ιστοσελίδες. Και στις δύο περιπτώσεις ο διακομιστής ελέγχει την κυριότητα σε κάθε κλήση: η επιχείρηση ενός άλλου λογαριασμού εμφανίζεται ως «δεν βρέθηκε».

Διαχείριση συνδεδεμένων εφαρμογών και tokens

Ο δικός διακομιστής κάθε επιχείρησης

Κάθε δημοσιευμένη επιχείρηση στο to.co έχει και δικό της διακομιστή MCP, στη δική της διεύθυνση με το /mcp στο τέλος, για παράδειγμα https://mybusiness.uk.to.co/mcp. Είναι διακομιστής ξεχωριστός από το mcp.to.co, με δικά του εργαλεία για αυτή τη μία επιχείρηση: τι δημοσιεύει στη σελίδα της (ποια είναι, πώς επικοινωνεί κανείς μαζί της, πότε και πού είναι ανοιχτή και τι επιτρέπει στους βοηθούς), μηνύματα όπου η επιχείρηση τα δέχεται και εργαλεία για τον κάτοχό της. Κανένα δεν αναζητά άλλη επιχείρηση και κανένα δεν δέχεται διεύθυνση. Οι ερωτήσεις για την επιχείρηση είναι δωρεάν και δεν απαιτούν σύνδεση. Ο διακομιστής κάθε επιχείρησης τεκμηριώνεται στη δική της διεύθυνση, στο /mcp/docs, στη γλώσσα του αναγνώστη. Η σελίδα της επιχείρησης παραπέμπει σε αυτόν και το llms.txt της και μια κεφαλίδα Link (rel="service-desc") δείχνουν την κάρτα διακομιστή της, /.well-known/mcp.json.

Για να συνδεθείτε, προσθέστε τη διεύθυνση της επιχείρησης, που τελειώνει σε /mcp, στον βοηθό σας ως προσαρμοσμένο connector ή διακομιστή MCP. Η σύνδεση λειτουργεί όπως περιγράφεται στην ενότητα Σύνδεση και ισχύει μόνο για αυτή την επιχείρηση: ένα token για άλλη επιχείρηση ή για το mcp.to.co απορρίπτεται. Ο κάτοχος βρίσκει τη διεύθυνση στο my.to.co, στην καρτέλα Βοηθοί AI της επιχείρησης.

Η αναζήτηση μιας επιχείρησης δεν κοστίζει τίποτα, με σύνδεση ή χωρίς: κάθε καλών (ένα token ή, χωρίς αυτό, μια διεύθυνση IP) μπορεί να κάνει 600 αναζητήσεις την ώρα στον διακομιστή κάθε επιχείρησης. Μια κλήση που απαιτεί σύνδεση πληρώνεται από όποιον την κάνει. Ο λογαριασμός του κατόχου χρησιμοποιεί τις μηνιαίες μονάδες API της επιχείρησης, σε κάθε πρόγραμμα. Οποιοσδήποτε άλλος έχει δικό του όριο σε όλες τις επιχειρήσεις: 60 κλήσεις την ώρα και 500 τον μήνα. Πέρα από τις 500 του μήνα, μια επιχείρηση που έχει ο δικός τους λογαριασμός στο to.co πληρώνει από τις μηνιαίες μονάδες API της· αν δεν έχουν, οι κλήσεις απορρίπτονται μέχρι την 1η. Οι απορρίψεις είναι HTTP 429: credits_exhausted όταν εξαντληθεί ο μήνας της επιχείρησης, allowance_exhausted για τον μήνα του ατόμου και rate_limited με Retry-After για μια ώρα.

Στα προγράμματα Pro και Grow, ο κάτοχος μπορεί να επιτρέψει στους βοηθούς να στείλουν στην επιχείρηση ένα μήνυμα με το εργαλείο messages, αφού το δει το άτομο για λογαριασμό του οποίου ενεργεί ο βοηθός και ζητήσει να σταλεί, με το δικό του όνομα και τα στοιχεία επικοινωνίας του. Είναι απενεργοποιημένο μέχρι να το ενεργοποιήσει ο κάτοχος.

Εργαλεία

Κάθε σύνδεση έχει τα τέσσερα εργαλεία παρακάτω· οι συνδεδεμένοι λογαριασμοί έχουν επίσης εργαλεία για παραστατικά, εμπορικούς συνεργάτες και μηνύματα. Καθένα δέχεται ένα όρισμα action που λέει τι να κάνει, μαζί με τα ορίσματα που χρειάζεται αυτή η ενέργεια. Τα ονόματα ορισμάτων και πεδίων αποτελέσματος είναι snake_case, όπως στο API του to.co. Κάθε αποτέλεσμα είναι JSON, που επιστρέφεται ως δομημένο περιεχόμενο με αντίστοιχο σχήμα εξόδου. Το ωράριο λειτουργίας διατηρεί την αποθηκευμένη μορφή του: day (0 για Κυριακή έως 6 για Σάββατο) ή date (YYYY-MM-DD), open, open_time και close_time σε 24ωρη μορφή HH:mm, με ώρα κλεισίματος νωρίτερη από την ώρα ανοίγματος να συνεχίζεται μετά τα μεσάνυχτα.

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.

ΕνέργειαΤι κάνειΟρίσματαΠρόσβαση
resolveThe business at a to.co address.
  • host string, υποχρεωτικό A to.co address, e.g. mybusiness.uk.to.co or mybusiness-bristol.biz.to.co
Οποιοσδήποτε
Μόνο ανάγνωση
websiteThe businesses whose website is on this hostname. A website can belong to more than one business, so this returns a list.
  • website string, υποχρεωτικό The business's own website, e.g. mybusiness.com or https://www.mybusiness.com/
Οποιοσδήποτε
Μόνο ανάγνωση
searchBusinesses whose name matches, newest first.
  • query string, υποχρεωτικό Part of the business name, at least 2 characters
  • limit integer Maximum results, 1-25 (default 10)
Οποιοσδήποτε
Μόνο ανάγνωση

Παράδειγμα κλήσης

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

ΕνέργειαΤι κάνειΟρίσματαΠρόσβαση
listEvery business the account owns, with its record key and publish status.ΚανέναΣύνδεση, εμβέλεια companies:read
Μόνο ανάγνωση
getOne business the account owns, by record key.
  • domain string, υποχρεωτικό The record key of a company you own, as returned by companies list (the `domain` field)
Σύνδεση, εμβέλεια companies:read
Μόνο ανάγνωση
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, υποχρεωτικό 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
Σύνδεση, εμβέλεια companies:write
Αλλάζει δεδομένα

Παράδειγμα κλήσης

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

ΕνέργειαΤι κάνειΟρίσματαΠρόσβαση
listEvery location of a business you own, with its record key, kind (registered or trading), hours, phones and profiles.
  • domain string, υποχρεωτικό The record key of a company you own, as returned by companies list (the `domain` field)
Σύνδεση, εμβέλεια companies:read
Μόνο ανάγνωση
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, υποχρεωτικό The record key of a company you own, as returned by companies list (the `domain` field)
  • location string, υποχρεωτικό 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
Σύνδεση, εμβέλεια companies:write
Αλλάζει δεδομένα

Παράδειγμα κλήσης

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

help — Connection and usage help

Check this connection and read the usage guide.

ΕνέργειαΤι κάνειΟρίσματαΠρόσβαση
whoamiWhether this connection is signed in, and which tools and actions it can use.ΚανέναΟποιοσδήποτε
Μόνο ανάγνωση
guideThe usage guide as Markdown (also the resource toco://guide).ΚανέναΟποιοσδήποτε
Μόνο ανάγνωση

Παράδειγμα κλήσης

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

Πόροι

  • 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

Prompts

  • look_up_business — Find a business on to.co by its to.co address, website or name, and summarize its record. Ορίσματα: business.
  • review_my_profile — Read a business you own and suggest clearer wording for its public profile. Changes nothing until you confirm. Ορίσματα: domain.

Σφάλματα

Μια κλήση που ο βοηθός μπορεί να διορθώσει επιστρέφει ως αποτέλεσμα εργαλείου σημειωμένο ως σφάλμα, που αρχίζει με σταθερό κωδικό και λέει τι να αλλάξει:

  • invalid_arguments — Ένα όρισμα λείπει, είναι εκτός ορίων ή άγνωστο (τα ονόματα πεδίων είναι snake_case), ή η ενέργεια είναι άγνωστη.
  • not_found — Καμία δημοσιευμένη επιχείρηση δεν ταιριάζει ή καμία επιχείρηση ή τοποθεσία που σας ανήκει δεν έχει αυτό το κλειδί καταχώρισης.
  • unauthenticated — Η ενέργεια απαιτεί σύνδεση (εμφανίζεται μόνο σε πελάτες που δεν ενεργούν με βάση το HTTP 401 παρακάτω).
  • insufficient_scope — Στη σύνδεση δεν επιτράπηκε αυτή η ενέργεια, για παράδειγμα μια αλλαγή ενώ επιτρεπόταν μόνο η ανάγνωση.

Μια κλήση εταιρειών ή τοποθεσιών χωρίς σύνδεση λαμβάνει HTTP 401 με κεφαλίδα WWW-Authenticate που δείχνει τα μεταδεδομένα του προστατευόμενου πόρου του διακομιστή, και έτσι ο βοηθός ξέρει να ξεκινήσει σύνδεση. Μια ενέργεια εκτός όσων επιτρέψατε λαμβάνει HTTP 403 με error=insufficient_scope και την εμβέλεια που πρέπει να ζητηθεί. Ένα άκυρο, ληγμένο ή ανακαλεσμένο token λαμβάνει HTTP 401 πριν εκτελεστεί οποιοδήποτε εργαλείο· δεν αντιμετωπίζεται ποτέ ως απουσία token. Πολλά αιτήματα λαμβάνουν HTTP 429 με κεφαλίδα Retry-After.

Όρια

  • 120 αιτήματα το λεπτό ανά token πράκτορα ή, χωρίς αυτό, ανά διεύθυνση IP.
  • Σώματα αιτημάτων έως 1024 KB.
  • Η αναζήτηση επιστρέφει έως 25 επιχειρήσεις ανά κλήση.

Εντοπισμός

Δεδομένα και απόρρητο

Οι αναζητήσεις επιστρέφουν μόνο δημοσιευμένες καταχωρίσεις, τα ίδια στοιχεία με τη δημόσια σελίδα της επιχείρησης. Ο διακομιστής καταγράφει ποιο εργαλείο και ποια ενέργεια εκτελέστηκε, αν πέτυχε και πόσο διήρκεσε, χωρίς ορίσματα και χωρίς περιεχόμενο καταχωρίσεων. Όταν συνδέετε έναν βοηθό, το to.co κρατά αρχείο της σύνδεσης (το όνομα της εφαρμογής, τι επιτρέψατε, πότε δημιουργήθηκε και χρησιμοποιήθηκε τελευταία φορά), που παραμένει ως αρχείο ασφαλείας αφού την αποσυνδέσετε.

Επόμενα βήματα

Γλώσσα