Server MCP to.co
Biarkan asisten AI mencari catatan bisnis yang diterbitkan di to.co, dan menjaga profil bisnis Anda sendiri tetap mutakhir. Mencari bisnis gratis dan tidak perlu masuk.
- URL server
https://mcp.to.co/mcp- Transport
- Streamable HTTP (revisi protokol MCP 2026-07-28, 2025-11-25)
Hubungkan asisten Anda
Tambahkan URL server ke asisten Anda. Pencarian langsung berfungsi. Agar asisten dapat mengelola bisnis Anda sendiri, masuk ke to.co saat diminta, seperti dijelaskan di bagian Masuk.
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.
Masuk
Alat identitas dan bantuan tidak memerlukan proses masuk. Alat perusahaan dan lokasi bekerja pada bisnis yang dimiliki akun Anda, sehingga asisten harus bertindak sebagai Anda. Ada dua cara.
Masuk dengan to.co (OAuth). Saat asisten pertama kali menggunakan alat perusahaan atau lokasi, server menjawab bahwa diperlukan proses masuk, dan asisten membuka halaman to.co tempat Anda masuk dan melihat apa yang dimintanya: membaca bisnis Anda, dan mengubah profil publiknya. Anda dapat menghapus centang pada perubahan. Asisten lalu mendapat token yang berlaku satu jam dan memperbarui dirinya sendiri; Anda dapat memutuskan koneksinya kapan saja di halaman Masuk dan keamanan. Ini berfungsi pada asisten yang mendukung proses masuk MCP (OAuth).
Atau gunakan token agen, untuk skrip dan asisten tanpa proses masuk MCP. Buat token di halaman Masuk dan keamanan di my.to.co. Token berlaku 90 hari, diawali dengan toco_at_, dapat melakukan semua yang dapat dilakukan alat perusahaan dan lokasi, dan Anda dapat mencabutnya di sana. Kirim sebagai Authorization: Bearer toco_at_…. Perlakukan seperti kata sandi: token ditolak jika berasal dari halaman web. Dengan cara mana pun, server memeriksa kepemilikan pada setiap panggilan: bisnis milik akun lain akan terbaca sebagai tidak ditemukan.
Kelola aplikasi dan token yang terhubung
Server milik setiap bisnis
Setiap bisnis yang diterbitkan di to.co juga memiliki server MCP sendiri, di alamatnya sendiri dengan /mcp di bagian akhir, misalnya https://mybusiness.uk.to.co/mcp. Server ini terpisah dari mcp.to.co, dengan alat sendiri tentang satu bisnis tersebut: apa yang diterbitkannya di halamannya (siapa bisnis itu, cara menghubunginya, kapan dan di mana bisnis itu buka, serta apa yang diizinkannya untuk dilakukan asisten), pesan jika bisnis tersebut menerimanya, dan alat untuk pemiliknya. Tidak ada satu pun yang mencari bisnis lain, dan tidak ada yang menerima alamat. Bertanya tentang bisnis tersebut gratis dan tidak perlu masuk. Server setiap bisnis didokumentasikan di alamatnya sendiri, di /mcp/docs, dalam bahasa pembaca. Halaman bisnis menautkan ke sana, dan llms.txt-nya serta header Link (rel="service-desc") mengarah ke kartu servernya, /.well-known/mcp.json.
Untuk terhubung, tambahkan alamat bisnis, yang diakhiri dengan /mcp, ke asisten Anda sebagai konektor kustom atau server MCP. Proses masuk berjalan seperti yang dijelaskan di bagian Masuk, dan koneksi hanya berlaku untuk bisnis tersebut: token untuk bisnis lain, atau untuk mcp.to.co, akan ditolak. Pemilik menemukan alamatnya di my.to.co, pada tab Asisten AI bisnis tersebut.
Mencari sebuah bisnis tidak dikenai biaya, baik sudah masuk maupun belum: setiap pemanggil (token, atau alamat IP jika tanpa token) dapat melakukan 600 pencarian per jam di server setiap bisnis. Panggilan yang memerlukan proses masuk dibayar oleh pihak yang melakukannya. Akun pemilik menggunakan kredit API bulanan bisnis tersebut, di semua paket. Pihak lain memiliki jatah sendiri untuk semua bisnis: 60 panggilan per jam dan 500 per bulan. Setelah melewati 500 dalam sebulan, bisnis yang dimiliki akun mereka sendiri di to.co membayar dari kredit API bulanannya; tanpa bisnis tersebut, panggilan ditolak hingga tanggal 1. Penolakan berupa HTTP 429: credits_exhausted jika jatah bulan bisnis tersebut sudah habis, allowance_exhausted untuk jatah bulanan orang tersebut, dan rate_limited dengan Retry-After untuk batas per jam.
Pada paket Pro dan Grow, pemilik dapat mengizinkan asisten mengirim pesan kepada bisnis dengan alat messages, setelah orang yang diwakili asisten tersebut melihat pesannya dan meminta agar pesan itu dikirim, dengan nama dan detail kontaknya sendiri. Fitur ini nonaktif sampai pemilik mengaktifkannya.
Alat
Setiap koneksi memiliki empat alat di bawah ini; akun yang sudah masuk juga mendapatkan alat untuk dokumen, mitra dagang, dan pesan. Masing-masing menerima argumen action yang menyatakan apa yang harus dilakukan, ditambah argumen yang diperlukan oleh action tersebut. Nama field argumen dan hasil menggunakan snake_case, seperti API to.co. Setiap hasil berupa JSON, dikembalikan sebagai konten terstruktur dengan skema output yang sesuai. Jam buka disimpan dalam bentuk aslinya: day (0 untuk Minggu hingga 6 untuk Sabtu) atau date (YYYY-MM-DD), open, open_time dan close_time dalam format 24 jam HH:mm; waktu tutup yang lebih awal dari waktu buka berarti berlanjut melewati tengah malam.
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.
| Action | Fungsinya | Argumen | Akses |
|---|---|---|---|
resolve | The business at a to.co address. |
| Siapa saja Hanya baca |
website | The businesses whose website is on this hostname. A website can belong to more than one business, so this returns a list. |
| Siapa saja Hanya baca |
search | Businesses whose name matches, newest first. |
| Siapa saja Hanya baca |
Contoh panggilan
{
"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.
| Action | Fungsinya | Argumen | Akses |
|---|---|---|---|
list | Every business the account owns, with its record key and publish status. | Tidak ada | Masuk, cakupan companies:readHanya baca |
get | One business the account owns, by record key. |
| Masuk, cakupan companies:readHanya baca |
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. |
| Masuk, cakupan companies:writeMengubah data |
Contoh panggilan
{
"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.
| Action | Fungsinya | Argumen | Akses |
|---|---|---|---|
list | Every location of a business you own, with its record key, kind (registered or trading), hours, phones and profiles. |
| Masuk, cakupan companies:readHanya baca |
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. |
| Masuk, cakupan companies:writeMengubah data |
Contoh panggilan
{
"name": "locations",
"arguments": {
"action": "list",
"domain": "yxpx6pdx.uk.to.co"
}
}
help — Connection and usage help
Check this connection and read the usage guide.
| Action | Fungsinya | Argumen | Akses |
|---|---|---|---|
whoami | Whether this connection is signed in, and which tools and actions it can use. | Tidak ada | Siapa saja Hanya baca |
guide | The usage guide as Markdown (also the resource toco://guide). | Tidak ada | Siapa saja Hanya baca |
Contoh panggilan
{
"name": "help",
"arguments": {
"action": "whoami"
}
}
Sumber daya
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
Prompt
look_up_business— Find a business on to.co by its to.co address, website or name, and summarize its record. Argumen:business.review_my_profile— Read a business you own and suggest clearer wording for its public profile. Changes nothing until you confirm. Argumen:domain.
Kesalahan
Panggilan yang dapat diperbaiki oleh asisten dikembalikan sebagai hasil alat yang ditandai sebagai kesalahan, diawali dengan kode tetap dan menyebutkan apa yang perlu diubah:
invalid_arguments— Ada argumen yang hilang, di luar rentang, atau tidak dikenal (nama field menggunakan snake_case), atau action-nya tidak dikenal.not_found— Tidak ada bisnis yang diterbitkan yang cocok, atau tidak ada bisnis atau lokasi milik Anda yang memiliki kunci catatan tersebut.unauthenticated— Action ini memerlukan proses masuk (hanya muncul pada klien yang tidak menanggapi HTTP 401 di bawah).insufficient_scope— Koneksi tidak diizinkan melakukan action ini, misalnya perubahan saat hanya membaca yang diizinkan.
Panggilan companies atau locations tanpa masuk mendapatkan HTTP 401 dengan header WWW-Authenticate yang mengarah ke metadata sumber daya terlindungi milik server, sehingga asisten tahu harus memulai proses masuk. Action di luar yang Anda izinkan mendapatkan HTTP 403 dengan error=insufficient_scope dan cakupan yang perlu diminta. Token yang tidak valid, kedaluwarsa, atau dicabut mendapatkan HTTP 401 sebelum alat apa pun berjalan; token tersebut tidak pernah diperlakukan sebagai tanpa token. Terlalu banyak permintaan mendapatkan HTTP 429 dengan header Retry-After.
Batas
- 120 permintaan per menit per token agen, atau per alamat IP jika tanpa token.
- Isi permintaan hingga 1024 KB.
- Pencarian mengembalikan hingga 25 bisnis per panggilan.
Penemuan
- Kartu server —
https://mcp.to.co/.well-known/mcp.json - Entri MCP Registry (co.to/mcp) —
https://mcp.to.co/server.json - Metadata sumber daya terlindungi (RFC 9728) —
https://mcp.to.co/.well-known/oauth-protected-resource - Metadata server otorisasi (RFC 8414) —
https://my.to.co/.well-known/oauth-authorization-server - llms.txt untuk situs ini
Data dan privasi
Pencarian hanya mengembalikan catatan yang diterbitkan, dengan fakta yang sama seperti halaman publik bisnis tersebut. Server mencatat alat dan action yang dijalankan, apakah berhasil, dan berapa lama waktunya, tanpa argumen dan tanpa isi catatan. Saat Anda menghubungkan asisten, to.co menyimpan catatan koneksi tersebut (nama aplikasi, apa yang Anda izinkan, kapan dibuat dan terakhir digunakan), yang tetap disimpan sebagai catatan keamanan setelah Anda memutuskan koneksinya.