דף הבית של to.co

שרת ה-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)

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

פעולהמה היא עושהארגומנטיםגישה
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

פרומפטים

  • 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 עסקים בכל קריאה.

גילוי

נתונים ופרטיות

חיפושים מחזירים רק רשומות שפורסמו, אותן עובדות כמו הדף הציבורי של העסק. השרת מתעד איזה כלי ופעולה רצו, אם זה עבד, וכמה זמן זה לקח, בלי ארגומנטים ובלי תוכן של רשומות. כשמחברים עוזר, to.co שומר תיעוד של החיבור (שם האפליקציה, מה הרשיתם, מתי הוא נוצר ומתי נעשה בו שימוש לאחרונה), שנשאר כרשומת אבטחה אחרי שמנתקים אותו.

השלבים הבאים

שפה

בחירה מתוך השפות שהאתר והאפליקציה תומכים בהן במלואן.