**Διακομιστής MCP** · [API](https://to.co/el-gr/docs/api?format=md)

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

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

[Συνδέστε τον βοηθό σας](#connect) · [Εργαλεία](#tools)

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

<a id="connect"></a>
## Συνδέστε τον βοηθό σας

Προσθέστε το 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.

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

## Σύνδεση

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

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

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

[Διαχείριση συνδεδεμένων εφαρμογών και tokens](https://my.to.co/account/security)

<a id="business"></a>
## Ο δικός διακομιστής κάθε επιχείρησης

Κάθε δημοσιευμένη επιχείρηση στο 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, αφού το δει το άτομο για λογαριασμό του οποίου ενεργεί ο βοηθός και ζητήσει να σταλεί, με το δικό του όνομα και τα στοιχεία επικοινωνίας του. Είναι απενεργοποιημένο μέχρι να το ενεργοποιήσει ο κάτοχος.

<a id="tools"></a>
## Εργαλεία

Κάθε σύνδεση έχει τα τέσσερα εργαλεία παρακάτω· οι συνδεδεμένοι λογαριασμοί έχουν επίσης εργαλεία για παραστατικά, εμπορικούς συνεργάτες και μηνύματα. Καθένα δέχεται ένα όρισμα 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.
  - `host` (string, υποχρεωτικό): A to.co address, e.g. mybusiness.uk.to.co or mybusiness-bristol.biz.to.co
- `website` (οποιοσδήποτε, μόνο ανάγνωση): The 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/
- `search` (οποιοσδήποτε, μόνο ανάγνωση): Businesses whose name matches, newest first.
  - `query` (string, υποχρεωτικό): Part of the business name, at least 2 characters
  - `limit` (integer): Maximum results, 1-25 (default 10)

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

```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` (σύνδεση, εμβέλεια `companies:read`, μόνο ανάγνωση): Every business the account owns, with its record key and publish status.
- `get` (σύνδεση, εμβέλεια `companies:read`, μόνο ανάγνωση): One 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)
- `update` (σύνδεση, εμβέλεια `companies:write`, αλλάζει δεδομένα): 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, υποχρεωτικό): 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

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

```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` (σύνδεση, εμβέλεια `companies:read`, μόνο ανάγνωση): Every 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)
- `update` (σύνδεση, εμβέλεια `companies:write`, αλλάζει δεδομένα): 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, υποχρεωτικό): 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

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

```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` (οποιοσδήποτε, μόνο ανάγνωση): 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).

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

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

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

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

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

- [Διαβάστε την ανάρτηση παρουσίασης](https://to.co/en-us/blog/mcp-server)
- [Ξεκινήστε](https://my.to.co/claim)
