to.co MCPサーバー
AIアシスタントが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)
- 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.
ログイン
identityツールとhelpツールはログイン不要です。companiesツールとlocationsツールはアカウントが所有する事業を扱うため、アシスタントがお客様として動作する必要があります。方法は2つあります。
to.coでログイン(OAuth)。アシスタントが初めてcompaniesツールまたはlocationsツールを使うと、サーバーがログインが必要だと応答し、アシスタントがto.coのページを開きます。そこでログインし、アシスタントが求めている内容(事業の読み取りと公開プロフィールの変更)を確認できます。変更のチェックは外せます。その後、アシスタントは1時間有効で自動更新されるトークンを受け取ります。接続は「ログインとセキュリティ」ページでいつでも解除できます。これはMCPのログイン(OAuth)に対応したアシスタントで使えます。
または、MCPのログインに対応していないスクリプトやアシスタントでは、エージェントトークンを使います。my.to.coの「ログインとセキュリティ」ページで作成してください。有効期間は90日で、toco_at_で始まり、companiesツールとlocationsツールでできることをすべて行え、同じページで取り消せます。Authorization: Bearer toco_at_…として送信してください。パスワードと同じように扱ってください。Webページからのトークンは拒否されます。どちらの方法でも、サーバーは呼び出しのたびに所有者を確認し、他のアカウントの事業は「見つかりません」として扱われます。
事業ごとの専用サーバー
to.coで公開されているすべての事業には、それぞれ専用のMCPサーバーもあります。アドレスは事業自身のアドレスの末尾に/mcpを付けたもので、たとえばhttps://mybusiness.uk.to.co/mcpです。mcp.to.coとは別のサーバーで、その1つの事業に関する独自のツールを備えています。事業ページで公開している内容(どんな事業か、連絡方法、営業日時と場所、AIアシスタントに許可していること)、事業が受け付けている場合のメッセージ、そしてオーナー向けのツールです。どのツールもほかの事業を検索することはなく、アドレスを引数に取ることもありません。事業についての問い合わせは無料で、ログインも不要です。各事業のサーバーは、その事業自身のアドレスの/mcp/docsに、読み手の言語で説明されています。事業ページからそこへリンクしており、事業のllms.txtとLinkヘッダー(rel="service-desc")がサーバーカード/.well-known/mcp.jsonを指しています。
接続するには、/mcpで終わる事業のアドレスを、AIアシスタントにカスタムコネクタまたはMCPサーバーとして追加してください。ログインは「ログイン」の項で説明しているとおりに行い、接続はその事業専用です。ほかの事業やmcp.to.co用のトークンは拒否されます。オーナーは、my.to.coの事業の「AIアシスタント」タブでこのアドレスを確認できます。
事業の検索は、ログインの有無にかかわらず無料です。呼び出し元(トークン、またはトークンがない場合はIPアドレス)ごとに、各事業のサーバーで1時間あたり600回まで検索できます。ログインが必要な呼び出しは、呼び出した人の負担になります。オーナーのアカウントは、どのプランでも事業の毎月のAPIクレジットを使います。それ以外の人には、すべての事業を通じた個人の上限があり、1時間あたり60回、1か月あたり500回です。月の500回を超えると、その人のアカウントでto.coに登録している事業があればその事業の毎月のAPIクレジットから支払われます。ない場合は、翌月1日まで呼び出しが拒否されます。拒否はHTTP 429で返され、事業の月の上限に達した場合はcredits_exhausted、個人の月の上限に達した場合はallowance_exhausted、1時間の上限に達した場合はRetry-After付きのrate_limitedです。
ProプランとGrowプランでは、オーナーはAIアシスタントがmessagesツールで事業にメッセージを送ることを許可できます。送信できるのは、AIアシスタントが代理で動いている本人がメッセージを確認して送信を求めた場合のみで、本人の名前と連絡先が添えられます。オーナーがオンにするまではオフです。
ツール
どの接続にも以下の4つのツールがあり、ログイン済みのアカウントには書類、取引先、メッセージ用のツールもあります。それぞれ、何をするかを示すaction引数と、そのアクションに必要な引数を受け取ります。引数と結果のフィールド名は、to.co APIと同じくsnake_caseです。結果はすべてJSONで、対応する出力スキーマ付きの構造化コンテンツとして返されます。営業時間は保存された形式のままです。day(日曜日の0から土曜日の6まで)またはdate(YYYY-MM-DD)、open、24時間制HH:mmのopen_timeとclose_timeで表し、閉店時刻が開店時刻より早い場合は深夜0時をまたぐことを意味します。
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.
| アクション | 内容 | 引数 | アクセス |
|---|---|---|---|
resolve | The business at a to.co address. |
| 誰でも 読み取り専用 |
website | The businesses whose website is on this hostname. A website can belong to more than one business, so this returns a list. |
| 誰でも 読み取り専用 |
search | Businesses whose name matches, newest first. |
| 誰でも 読み取り専用 |
呼び出し例
{
"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.
| アクション | 内容 | 引数 | アクセス |
|---|---|---|---|
list | Every business the account owns, with its record key and publish status. | なし | ログイン、スコープcompanies:read読み取り専用 |
get | One business the account owns, by record key. |
| ログイン、スコープcompanies:read読み取り専用 |
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. |
| ログイン、スコープ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.
| アクション | 内容 | 引数 | アクセス |
|---|---|---|---|
list | Every location of a business you own, with its record key, kind (registered or trading), hours, phones and profiles. |
| ログイン、スコープcompanies:read読み取り専用 |
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. |
| ログイン、スコープ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.
| アクション | 内容 | 引数 | アクセス |
|---|---|---|---|
whoami | Whether this connection is signed in, and which tools and actions it can use. | なし | 誰でも 読み取り専用 |
guide | The 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。
エラー
AIアシスタントが修正できる呼び出しは、エラーとしてマークされたツール結果として返されます。結果は固定のコードで始まり、何を変更すればよいかを示します。
invalid_arguments— 引数が不足している、範囲外、または不明です(フィールド名はsnake_caseです)。あるいはアクションが不明です。not_found— 一致する公開済みの事業がないか、そのレコードキーを持つ事業や所在地を所有していません。unauthenticated— このアクションにはログインが必要です(下記のHTTP 401に対応しないクライアントでのみ表示されます)。insufficient_scope— この接続ではこのアクションが許可されていません。たとえば、読み取りのみ許可されているのに変更しようとした場合です。
ログインせずにcompaniesまたはlocationsを呼び出すと、HTTP 401が返され、WWW-Authenticateヘッダーがサーバーの保護リソースメタデータを指します。AIアシスタントはこれを見てログインを開始します。許可した範囲外のアクションには、error=insufficient_scopeと要求すべきスコープを含むHTTP 403が返されます。無効、期限切れ、または取り消されたトークンには、ツールが実行される前にHTTP 401が返されます。トークンなしとして扱われることはありません。リクエストが多すぎる場合は、Retry-Afterヘッダー付きのHTTP 429が返されます。
上限
- エージェントトークンごと(トークンがない場合はIPアドレスごと)に1分あたり120リクエスト。
- リクエスト本文は1024 KBまで。
- 検索は1回の呼び出しで最大25件の事業を返します。
検出
- サーバーカード —
https://mcp.to.co/.well-known/mcp.json - MCP Registryのエントリー(co.to/mcp) —
https://mcp.to.co/server.json - 保護リソースメタデータ(RFC 9728) —
https://mcp.to.co/.well-known/oauth-protected-resource - 認可サーバーメタデータ(RFC 8414) —
https://my.to.co/.well-known/oauth-authorization-server - このサイトのllms.txt
データとプライバシー
検索で返されるのは公開済みのレコードのみで、事業の公開ページと同じ情報です。サーバーは、どのツールとアクションが実行されたか、成功したかどうか、かかった時間を記録しますが、引数やレコードの内容は記録しません。AIアシスタントを接続すると、to.coは接続の記録(アプリ名、許可した内容、作成日時と最終利用日時)を保持します。この記録は、接続を解除した後もセキュリティ記録として残ります。