الصفحة الرئيسية لـ to.co

خادم MCP في to.co

اسمح لمساعد ذكاء اصطناعي بالبحث عن سجلات الأعمال المنشورة على 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)

  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، في علامة تبويب «مساعدو الذكاء الاصطناعي» للنشاط التجاري.

البحث عن نشاط تجاري لا يكلّف شيئًا، سواء سُجّل الدخول أم لا: يمكن لكل مستدعٍ (رمز، أو عنوان IP دون رمز) إجراء 600 عملية بحث في الساعة على خادم كل نشاط تجاري. الطلب الذي يحتاج إلى تسجيل دخول يدفع مقابله من يجريه. يستهلك حساب المالك أرصدة API الشهرية للنشاط التجاري، في كل الخطط. أما أي شخص آخر فله حصته الخاصة عبر كل الأنشطة التجارية: 60 طلب في الساعة و500 في الشهر. بعد تجاوز 500 الشهرية، يدفع نشاط تجاري يملكه حسابه على to.co من أرصدة API الشهرية الخاصة به؛ وإن لم يوجد، تُرفض الطلبات حتى اليوم الأول من الشهر. حالات الرفض هي 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 بسجل للاتصال (اسم التطبيق، وما سمحت به، ووقت إنشائه وآخر استخدام له)، ويبقى كسجل أمني بعد قطع اتصاله.

الخطوات التالية

اللغة

اختر من اللغات التي يدعمها الموقع والتطبيق بالكامل.