to.co ana sayfa

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.

Asistanınızı bağlayın Araçlar

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)

  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.

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.

EylemNe yaparBağımsız değişkenlerErişim
resolveThe business at a to.co address.
  • host string, zorunlu A to.co address, e.g. mybusiness.uk.to.co or mybusiness-bristol.biz.to.co
Herkes
Salt okunur
websiteThe businesses whose website is on this hostname. A website can belong to more than one business, so this returns a list.
  • website string, zorunlu The business's own website, e.g. mybusiness.com or https://www.mybusiness.com/
Herkes
Salt okunur
searchBusinesses whose name matches, newest first.
  • query string, zorunlu Part of the business name, at least 2 characters
  • limit integer Maximum results, 1-25 (default 10)
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.

EylemNe yaparBağımsız değişkenlerErişim
listEvery business the account owns, with its record key and publish status.YokOturum açma, kapsam companies:read
Salt okunur
getOne business the account owns, by record key.
  • domain string, zorunlu The record key of a company you own, as returned by companies list (the `domain` field)
Oturum açma, kapsam companies:read
Salt okunur
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, zorunlu 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
Oturum açma, kapsam companies:write
Verileri 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.

EylemNe yaparBağımsız değişkenlerErişim
listEvery location of a business you own, with its record key, kind (registered or trading), hours, phones and profiles.
  • domain string, zorunlu The record key of a company you own, as returned by companies list (the `domain` field)
Oturum açma, kapsam companies:read
Salt okunur
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, zorunlu The record key of a company you own, as returned by companies list (the `domain` field)
  • location string, zorunlu 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
Oturum açma, kapsam companies:write
Verileri 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.

EylemNe yaparBağımsız değişkenlerErişim
whoamiWhether this connection is signed in, and which tools and actions it can use.YokHerkes
Salt okunur
guideThe usage guide as Markdown (also the resource toco://guide).YokHerkes
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

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.

Sonraki adımlar

Dil

Sitenin ve uygulamanın tam olarak desteklediği dillerden birini seçin.