**שרת MCP** · [API](https://to.co/he-il/docs/api?format=md)

# שרת ה-MCP של to.co

אפשר לתת לעוזר AI לחפש רשומות עסקים שפורסמו ב-to.co, ולשמור את פרופיל העסק שלכם מעודכן. חיפוש עסקים הוא בחינם ולא דורש כניסה.

[חיבור העוזר שלכם](#connect) · [כלים](#tools)

- כתובת השרת: `https://mcp.to.co/mcp`
- תעבורה: Streamable HTTP (גרסאות פרוטוקול MCP‏ 2026-07-28, 2025-11-25)

<a id="connect"></a>
## חיבור העוזר שלכם

מוסיפים את כתובת השרת לעוזר שלכם. חיפושים עובדים מיד. כדי לאפשר לו לנהל את העסקים שלכם, יש להיכנס ל-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 שבו אתם נכנסים ורואים מה הוא מבקש: קריאת העסקים שלכם ושינוי הפרופיל הציבורי שלהם. אפשר לבטל את הסימון של השינויים. אז הוא מקבל אסימון שתקף שעה ומתחדש מעצמו; אפשר לנתק אותו בכל זמן בדף "כניסה ואבטחה". זה עובד בעוזרים שתומכים בכניסת MCP ‏(OAuth).

או להשתמש באסימון סוכן, לסקריפטים ולעוזרים בלי כניסת MCP. יוצרים אחד בדף "כניסה ואבטחה" ב-my.to.co. הוא תקף 90 יום, מתחיל ב-toco_at_, יכול לעשות כל מה שכלי החברות והמיקומים עושים, ואפשר לבטל אותו שם. שולחים אותו כ-Authorization: Bearer toco_at_…. יש להתייחס אליו כמו לסיסמה: אסימונים נדחים מדפי אינטרנט. בכל מקרה, השרת בודק בעלות בכל קריאה: עסק של חשבון אחר נקרא כ"לא נמצא".

[ניהול אפליקציות מחוברות ואסימונים](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, לעוזר שלכם כמחבר מותאם או כשרת MCP. הכניסה עובדת כמתואר תחת "כניסה", והחיבור מיועד לעסק הזה בלבד: אסימון של עסק אחר, או של mcp.to.co, נדחה. הבעלים מוצאים את הכתובת ב-my.to.co, בלשונית "עוזרי AI" של העסק.

חיפוש עסק לא עולה כלום, עם כניסה או בלי: כל מבצע קריאה (אסימון, או כתובת IP בלי אסימון) יכול לבצע 600 חיפושים בשעה בשרת של כל עסק. על קריאה שדורשת כניסה משלם מי שמבצע אותה. החשבון של הבעלים משתמש בקרדיטים החודשיים ל-API של העסק, בכל תוכנית. לכל אחד אחר יש מכסה משלו בכל העסקים: 60 קריאות בשעה ו-500 בחודש. מעבר ל-500 של החודש, עסק שיש לחשבון שלו ב-to.co משלם מהקרדיטים החודשיים שלו ל-API; בלי עסק כזה, קריאות נדחות עד ה-1 בחודש. דחיות הן HTTP 429: credits_exhausted כשהחודש של העסק נוצל, allowance_exhausted לחודש של האדם, ו-rate_limited עם Retry-After לשעה.

ב-Pro וב-Grow, הבעלים יכולים לאפשר לעוזרים לשלוח לעסק הודעה עם כלי ההודעות, אחרי שהאדם שהעוזר פועל בשמו ראה אותה וביקש לשלוח אותה, עם השם ופרטי הקשר שלו. זה כבוי עד שהבעלים מפעילים את זה.

<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

## פרומפטים

- `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 וההרשאה שיש לבקש. אסימון לא תקין, שתוקפו פג או שבוטל מקבל HTTP 401 לפני שכלי כלשהו רץ; הוא אף פעם לא מטופל כהיעדר אסימון. יותר מדי בקשות מקבלות HTTP 429 עם כותרת Retry-After.

## מגבלות

- 120 בקשות בדקה לכל אסימון סוכן, או לכל כתובת 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)
