שרת ה-MCP של to.co
אפשר לתת לעוזר AI לחפש רשומות עסקים שפורסמו ב-to.co, ולשמור את פרופיל העסק שלכם מעודכן. חיפוש עסקים הוא בחינם ולא דורש כניסה.
- כתובת השרת
https://mcp.to.co/mcp- תעבורה
- Streamable HTTP (גרסאות פרוטוקול MCP 2026-07-28, 2025-11-25)
חיבור העוזר שלכם
מוסיפים את כתובת השרת לעוזר שלכם. חיפושים עובדים מיד. כדי לאפשר לו לנהל את העסקים שלכם, יש להיכנס ל-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 שבו אתם נכנסים ורואים מה הוא מבקש: קריאת העסקים שלכם ושינוי הפרופיל הציבורי שלהם. אפשר לבטל את הסימון של השינויים. אז הוא מקבל אסימון שתקף שעה ומתחדש מעצמו; אפשר לנתק אותו בכל זמן בדף "כניסה ואבטחה". זה עובד בעוזרים שתומכים בכניסת MCP (OAuth).
או להשתמש באסימון סוכן, לסקריפטים ולעוזרים בלי כניסת MCP. יוצרים אחד בדף "כניסה ואבטחה" ב-my.to.co. הוא תקף 90 יום, מתחיל ב-toco_at_, יכול לעשות כל מה שכלי החברות והמיקומים עושים, ואפשר לבטל אותו שם. שולחים אותו כ-Authorization: Bearer toco_at_…. יש להתייחס אליו כמו לסיסמה: אסימונים נדחים מדפי אינטרנט. בכל מקרה, השרת בודק בעלות בכל קריאה: עסק של חשבון אחר נקרא כ"לא נמצא".
ניהול אפליקציות מחוברות ואסימונים
השרת של כל עסק
לכל עסק שפורסם ב-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, הבעלים יכולים לאפשר לעוזרים לשלוח לעסק הודעה עם כלי ההודעות, אחרי שהאדם שהעוזר פועל בשמו ראה אותה וביקש לשלוח אותה, עם השם ופרטי הקשר שלו. זה כבוי עד שהבעלים מפעילים את זה.
כלים
לכל חיבור יש את ארבעת הכלים שלמטה; חשבונות מחוברים מקבלים גם כלים למסמכים, לשותפי סחר ולהודעות. כל אחד מקבל ארגומנט 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
פרומפטים
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 - llms.txt של האתר הזה
נתונים ופרטיות
חיפושים מחזירים רק רשומות שפורסמו, אותן עובדות כמו הדף הציבורי של העסק. השרת מתעד איזה כלי ופעולה רצו, אם זה עבד, וכמה זמן זה לקח, בלי ארגומנטים ובלי תוכן של רשומות. כשמחברים עוזר, to.co שומר תיעוד של החיבור (שם האפליקציה, מה הרשיתם, מתי הוא נוצר ומתי נעשה בו שימוש לאחרונה), שנשאר כרשומת אבטחה אחרי שמנתקים אותו.