Ο διακομιστής 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)
- 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.
Σύνδεση
Τα εργαλεία ταυτότητας και βοήθειας δεν απαιτούν σύνδεση. Τα εργαλεία εταιρειών και τοποθεσιών λειτουργούν στις επιχειρήσεις που ανήκουν στον λογαριασμό σας, οπότε ο βοηθός πρέπει να ενεργεί ως εσείς. Υπάρχουν δύο τρόποι.
Σύνδεση με το 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.
| Ενέργεια | Τι κάνει | Ορίσματα | Πρόσβαση |
|---|---|---|---|
resolve | The business at a to.co address. |
| Οποιοσδήποτε Μόνο ανάγνωση |
website | The businesses whose website is on this hostname. A website can belong to more than one business, so this returns a list. |
| Οποιοσδήποτε Μόνο ανάγνωση |
search | Businesses whose name matches, newest first. |
| Οποιοσδήποτε Μόνο ανάγνωση |
Παράδειγμα κλήσης
{
"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 | Every business the account owns, with its record key and publish status. | Κανένα | Σύνδεση, εμβέλεια companies:readΜόνο ανάγνωση |
get | One business the account owns, by record key. |
| Σύνδεση, εμβέλεια companies:readΜόνο ανάγνωση |
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. |
| Σύνδεση, εμβέλεια 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.
| Ενέργεια | Τι κάνει | Ορίσματα | Πρόσβαση |
|---|---|---|---|
list | Every location of a business you own, with its record key, kind (registered or trading), hours, phones and profiles. |
| Σύνδεση, εμβέλεια companies:readΜόνο ανάγνωση |
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. |
| Σύνδεση, εμβέλεια 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.
| Ενέργεια | Τι κάνει | Ορίσματα | Πρόσβαση |
|---|---|---|---|
whoami | Whether this connection is signed in, and which tools and actions it can use. | Κανένα | Οποιοσδήποτε Μόνο ανάγνωση |
guide | The 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 επιχειρήσεις ανά κλήση.
Εντοπισμός
- Κάρτα διακομιστή —
https://mcp.to.co/.well-known/mcp.json - Καταχώριση στο MCP Registry (co.to/mcp) —
https://mcp.to.co/server.json - Μεταδεδομένα προστατευόμενου πόρου (RFC 9728) —
https://mcp.to.co/.well-known/oauth-protected-resource - Μεταδεδομένα διακομιστή εξουσιοδότησης (RFC 8414) —
https://my.to.co/.well-known/oauth-authorization-server - llms.txt για αυτόν τον ιστότοπο
Δεδομένα και απόρρητο
Οι αναζητήσεις επιστρέφουν μόνο δημοσιευμένες καταχωρίσεις, τα ίδια στοιχεία με τη δημόσια σελίδα της επιχείρησης. Ο διακομιστής καταγράφει ποιο εργαλείο και ποια ενέργεια εκτελέστηκε, αν πέτυχε και πόσο διήρκεσε, χωρίς ορίσματα και χωρίς περιεχόμενο καταχωρίσεων. Όταν συνδέετε έναν βοηθό, το to.co κρατά αρχείο της σύνδεσης (το όνομα της εφαρμογής, τι επιτρέψατε, πότε δημιουργήθηκε και χρησιμοποιήθηκε τελευταία φορά), που παραμένει ως αρχείο ασφαλείας αφού την αποσυνδέσετε.