to.co MCP sunucusu
Bir AI asistanının to.co'da yayımlanmış işletme kayıtlarını sorgulamasına ve kendi işletme profilinizi güncel tutmasına izin verin. İşletmeleri sorgulamak ücretsizdir ve oturum açmayı gerektirmez.
- Sunucu URL'si
https://mcp.to.co/mcp- Aktarım
- Streamable HTTP (MCP protokol sürümleri: 2026-07-28, 2025-11-25)
Asistanınızı bağlayın
Sunucu URL'sini asistanınıza ekleyin. Sorgulamalar hemen çalışır. Kendi işletmelerinizi yönetmesine izin vermek için, Oturum açma bölümünde açıklandığı gibi, istendiğinde to.co'da oturum açın.
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.
Oturum açma
Kimlik ve yardım araçları oturum açmayı gerektirmez. Şirketler ve konumlar araçları hesabınızın sahip olduğu işletmeler üzerinde çalışır; bu nedenle asistanın sizin adınıza hareket etmesi gerekir. Bunun iki yolu vardır.
to.co ile oturum açın (OAuth). Asistan şirketler veya konumlar aracını ilk kez kullandığında sunucu oturum açılması gerektiğini bildirir ve asistan, oturum açıp neyin istendiğini görebileceğiniz bir to.co sayfası açar: işletmelerinizi okuma ve herkese açık profillerini değiştirme. Değişiklik iznini kaldırabilirsiniz. Asistan ardından bir saat geçerli olan ve kendini yenileyen bir belirteç (token) alır; bağlantıyı istediğiniz zaman Oturum açma ve güvenlik sayfasından kesebilirsiniz. Bu, MCP oturum açmayı (OAuth) destekleyen asistanlarda çalışır.
Ya da MCP oturum açmayı desteklemeyen betikler ve asistanlar için bir ajan belirteci kullanın. my.to.co'daki Oturum açma ve güvenlik sayfasından bir tane oluşturun. 90 gün geçerlidir, toco_at_ ile başlar, şirketler ve konumlar araçlarının yapabildiği her şeyi yapabilir ve orada iptal edebilirsiniz. Authorization: Bearer toco_at_… olarak gönderin. Ona bir parola gibi davranın: web sayfalarından gelen belirteçler reddedilir. Her iki durumda da sunucu her çağrıda sahipliği kontrol eder: başka bir hesabın işletmesi bulunamadı olarak görünür.
Bağlı uygulamaları ve belirteçleri yönet
Her işletmenin kendi sunucusu
to.co'da yayımlanan her işletmenin, kendi adresinin sonuna /mcp eklenerek ulaşılan kendi MCP sunucusu da vardır; örneğin https://mybusiness.uk.to.co/mcp. Bu, mcp.to.co'dan ayrı bir sunucudur ve yalnızca o işletmeye ait kendi araçları vardır: işletmenin sayfasında yayımladıkları (kim olduğu, nasıl ulaşılacağı, ne zaman ve nerede açık olduğu ve asistanların neler yapmasına izin verdiği), işletme mesaj kabul ediyorsa mesajlar ve işletme sahibine yönelik araçlar. Bunların hiçbiri başka bir işletmeyi aramaz ve hiçbiri adres almaz. İşletme hakkında soru sormak ücretsizdir ve oturum açmayı gerektirmez. Her işletmenin sunucusu, kendi adresinde /mcp/docs altında, okuyucunun dilinde belgelenir. İşletmenin sayfası bu belgelere bağlantı verir; işletmenin llms.txt dosyası ve bir Link başlığı (rel="service-desc") ise sunucu kartını, yani /.well-known/mcp.json dosyasını gösterir.
Bağlanmak için işletmenin /mcp ile biten adresini asistanınıza özel bağlayıcı veya MCP sunucusu olarak ekleyin. Oturum açma, Oturum açma bölümünde anlatıldığı gibi çalışır ve bağlantı yalnızca o işletme içindir: başka bir işletmeye veya mcp.to.co'ya ait bir belirteç reddedilir. İşletme sahibi bu adresi my.to.co'da, işletmenin AI asistanları sekmesinde bulur.
Bir işletmeyi aramak, oturum açılmış olsun ya da olmasın ücretsizdir: her arayan (bir belirteç veya belirteç yoksa bir IP adresi) her işletmenin sunucusunda saatte 600 arama yapabilir. Oturum açmayı gerektiren bir çağrının bedelini çağrıyı yapan öder. İşletme sahibinin hesabı, her planda işletmenin aylık API kredilerini kullanır. Diğer herkesin tüm işletmeler genelinde geçerli kendi kullanım hakkı vardır: saatte 60 ve ayda 500 çağrı. Ayın 500 çağrısı aşıldıktan sonra, kişinin kendi hesabında to.co'da bir işletmesi varsa ödeme o işletmenin aylık API kredilerinden yapılır; yoksa çağrılar ayın 1'ine kadar reddedilir. Retler HTTP 429 olarak döner: işletmenin aylık kredisi bittiğinde credits_exhausted, kişinin aylık hakkı bittiğinde allowance_exhausted ve saatlik sınır için Retry-After ile birlikte rate_limited.
Pro ve Grow planlarında işletme sahibi, asistanların messages aracıyla işletmeye mesaj göndermesine izin verebilir. Bunun için asistanın adına hareket ettiği kişinin mesajı görmüş ve kendi adı ve iletişim bilgileriyle gönderilmesini istemiş olması gerekir. Bu özellik, işletme sahibi açana kadar kapalıdır.
Araçlar
Her bağlantıda aşağıdaki dört araç bulunur; oturum açmış hesaplar ayrıca belgeler, ticari ortaklar ve mesajlar için araçlar alır. Her araç ne yapılacağını belirten bir action bağımsız değişkeni ve o eylemin gerektirdiği bağımsız değişkenleri alır. Bağımsız değişken ve sonuç alanı adları, to.co API'sinde olduğu gibi snake_case biçimindedir. Her sonuç JSON'dur ve eşleşen bir çıktı şemasıyla yapılandırılmış içerik olarak döner. Çalışma saatleri kayıtlı biçimlerini korur: day (Pazar için 0'dan Cumartesi için 6'ya) veya date (YYYY-MM-DD), open, 24 saatlik HH:mm biçiminde open_time ve close_time; açılış saatinden önceki bir kapanış saati gece yarısını geçtiği anlamına gelir.
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.
| Eylem | Ne yapar | Bağımsız değişkenler | Erişim |
|---|---|---|---|
resolve | The business at a to.co address. |
| Herkes Salt okunur |
website | The businesses whose website is on this hostname. A website can belong to more than one business, so this returns a list. |
| Herkes Salt okunur |
search | Businesses whose name matches, newest first. |
| Herkes Salt okunur |
Örnek çağrı
{
"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.
| Eylem | Ne yapar | Bağımsız değişkenler | Erişim |
|---|---|---|---|
list | Every business the account owns, with its record key and publish status. | Yok | Oturum açma, kapsam companies:readSalt okunur |
get | One business the account owns, by record key. |
| Oturum açma, kapsam companies:readSalt okunur |
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. |
| Oturum açma, kapsam companies:writeVerileri değiştirir |
Örnek çağrı
{
"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.
| Eylem | Ne yapar | Bağımsız değişkenler | Erişim |
|---|---|---|---|
list | Every location of a business you own, with its record key, kind (registered or trading), hours, phones and profiles. |
| Oturum açma, kapsam companies:readSalt okunur |
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. |
| Oturum açma, kapsam companies:writeVerileri değiştirir |
Örnek çağrı
{
"name": "locations",
"arguments": {
"action": "list",
"domain": "yxpx6pdx.uk.to.co"
}
}
help — Connection and usage help
Check this connection and read the usage guide.
| Eylem | Ne yapar | Bağımsız değişkenler | Erişim |
|---|---|---|---|
whoami | Whether this connection is signed in, and which tools and actions it can use. | Yok | Herkes Salt okunur |
guide | The usage guide as Markdown (also the resource toco://guide). | Yok | Herkes Salt okunur |
Örnek çağrı
{
"name": "help",
"arguments": {
"action": "whoami"
}
}
Kaynaklar
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
İstemler
look_up_business— Find a business on to.co by its to.co address, website or name, and summarize its record. Bağımsız değişkenler:business.review_my_profile— Read a business you own and suggest clearer wording for its public profile. Changes nothing until you confirm. Bağımsız değişkenler:domain.
Hatalar
Asistanın düzeltebileceği bir çağrı, hata olarak işaretlenmiş bir araç sonucu olarak döner; sonuç sabit bir kodla başlar ve neyin değiştirilmesi gerektiğini söyler:
invalid_arguments— Bir bağımsız değişken eksik, aralık dışında veya bilinmiyor (alan adları snake_case biçimindedir) ya da eylem bilinmiyor.not_found— Eşleşen yayımlanmış bir işletme yok veya sahibi olduğunuz hiçbir işletmede ya da konumda bu kayıt anahtarı yok.unauthenticated— Eylem oturum açmayı gerektiriyor (yalnızca aşağıdaki HTTP 401 yanıtına göre hareket etmeyen istemcilerde görülür).insufficient_scope— Bağlantıya bu eylem için izin verilmedi; örneğin yalnızca okumaya izin verilmişken bir değişiklik yapılmak istendi.
Oturum açmadan yapılan bir companies veya locations çağrısı, sunucunun korunan kaynak meta verilerini gösteren bir WWW-Authenticate başlığıyla HTTP 401 alır; asistan oturum açmayı başlatması gerektiğini bu şekilde anlar. İzin verdiğiniz kapsamın dışındaki bir eylem, error=insufficient_scope ve istenmesi gereken kapsamla birlikte HTTP 403 alır. Geçersiz, süresi dolmuş veya iptal edilmiş bir belirteç, hiçbir araç çalışmadan önce HTTP 401 alır; hiçbir zaman belirteç yokmuş gibi değerlendirilmez. Çok fazla istek, Retry-After başlığıyla HTTP 429 alır.
Sınırlar
- Aracı belirteci başına veya belirteç yoksa IP adresi başına dakikada 120 istek.
- İstek gövdeleri en fazla 1024 KB.
- Arama, çağrı başına en fazla 25 işletme döndürür.
Keşif
- Sunucu kartı —
https://mcp.to.co/.well-known/mcp.json - MCP Registry kaydı (co.to/mcp) —
https://mcp.to.co/server.json - Korunan kaynak meta verileri (RFC 9728) —
https://mcp.to.co/.well-known/oauth-protected-resource - Yetkilendirme sunucusu meta verileri (RFC 8414) —
https://my.to.co/.well-known/oauth-authorization-server - Bu sitenin llms.txt dosyası
Veriler ve gizlilik
Aramalar yalnızca yayımlanmış kayıtları, yani işletmenin herkese açık sayfasındaki bilgilerin aynısını döndürür. Sunucu, hangi aracın ve eylemin çalıştığını, başarılı olup olmadığını ve ne kadar sürdüğünü kaydeder; bağımsız değişkenleri ve kayıt içeriğini kaydetmez. Bir asistanı bağladığınızda to.co bağlantının kaydını tutar (uygulamanın adı, neye izin verdiğiniz, bağlantının ne zaman yapıldığı ve en son ne zaman kullanıldığı); bu kayıt, bağlantıyı kestikten sonra da güvenlik kaydı olarak saklanır.