to.coホーム

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)

  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.

ログイン

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.

アクション内容引数アクセス
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。

エラー

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件の事業を返します。

検出

データとプライバシー

検索で返されるのは公開済みのレコードのみで、事業の公開ページと同じ情報です。サーバーは、どのツールとアクションが実行されたか、成功したかどうか、かかった時間を記録しますが、引数やレコードの内容は記録しません。AIアシスタントを接続すると、to.coは接続の記録(アプリ名、許可した内容、作成日時と最終利用日時)を保持します。この記録は、接続を解除した後もセキュリティ記録として残ります。

次のステップ

言語

サイトとアプリが完全に対応している言語から選択してください。