to.co MCP 服务器
让 AI 助手查询 to.co 上已发布的企业记录,并保持您自己的企业资料为最新。查询企业免费,且无需登录。
- 服务器网址
https://mcp.to.co/mcp- 传输方式
- Streamable HTTP(MCP 协议版本 2026-07-28, 2025-11-25)
连接您的助手
将服务器网址添加到您的助手中。查询功能可立即使用。如需让助手管理您自己的企业,请在其提示时登录 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 工具作用于您账户拥有的企业,因此助手必须以您的身份操作。有两种方式。
使用 to.co 登录(OAuth)。当助手首次使用 companies 或 locations 工具时,服务器会回复需要登录,助手会打开一个 to.co 页面,您在其中登录并查看它请求的权限:读取您的企业,以及更改其公开资料。您可以取消勾选更改权限。之后它会获得一个有效期一小时并可自动续期的令牌;您可以随时在“登录与安全”页面断开连接。这适用于支持 MCP 登录(OAuth)的助手。
或者使用代理令牌,适用于脚本和不支持 MCP 登录的助手。在 my.to.co 的“登录与安全”页面创建。令牌有效期 90 天,以 toco_at_ 开头,可以执行 companies 和 locations 工具的所有操作,您可以在该页面撤销。以 Authorization: Bearer toco_at_… 的形式发送。请像对待密码一样对待它:来自网页的令牌会被拒绝。无论采用哪种方式,服务器都会在每次调用时核对所有权:其他账户的企业会显示为未找到。
每家企业自己的服务器
to.co 上每家已发布的企业还有自己的 MCP 服务器,位于其自己网址的 /mcp 下,例如 https://mybusiness.uk.to.co/mcp。它是独立于 mcp.to.co 的服务器,拥有专门针对该企业的工具:企业在其主页上发布的内容(它是谁、如何联系、何时何地营业,以及它允许助手做什么)、在企业接收的情况下发送消息,以及供其所有者使用的工具。这些工具都不会查询其他企业,也不接受网址参数。查询该企业免费,且无需登录。每家企业的服务器都在其自己网址的 /mcp/docs 下提供文档,使用读者的语言。企业主页链接到该文档,其 llms.txt 和 Link 标头(rel="service-desc")指向其服务器卡片 /.well-known/mcp.json。
如需连接,请将以 /mcp 结尾的企业网址作为自定义连接器或 MCP 服务器添加到您的助手中。登录方式如“登录”一节所述,且该连接仅对该企业有效:针对其他企业或 mcp.to.co 的令牌会被拒绝。所有者可在 my.to.co 中企业的“AI 助手”标签页找到该网址。
无论是否登录,查询企业都不收费:每个调用方(令牌;没有令牌时按 IP 地址计)在每家企业的服务器上每小时可查询 600 次。需要登录的调用由调用者付费。所有者的账户在所有套餐中都使用企业的月度 API 额度。其他任何人在所有企业间共享一份自己的额度:每小时 60 次,每月 500 次。超出每月 500 次后,如果其自己的账户在 to.co 上有企业,则从该企业的月度 API 额度中扣除;没有的话,调用会被拒绝,直到下月 1 日。拒绝时返回 HTTP 429:企业当月额度用完时为 credits_exhausted,个人当月额度用完时为 allowance_exhausted,每小时限制则为 rate_limited 并附 Retry-After。
在 Pro 和 Grow 套餐中,所有者可以允许助手通过 messages 工具向企业发送消息,前提是助手所代表的人已看过该消息并请求发送,且使用其本人的姓名和联系方式。此功能默认关闭,需所有者开启。
工具
每个连接都有以下四个工具;已登录的账户还可以使用单据、贸易伙伴和消息工具。每个工具接收一个 action 参数说明要做什么,以及该操作所需的参数。参数和结果的字段名使用 snake_case,与 to.co API 一致。所有结果均为 JSON,以结构化内容返回并附有匹配的输出架构。营业时间保持其存储形式:day(0 为周日至 6 为周六)或 date(YYYY-MM-DD),以及 open、open_time 和 close_time(24 小时制 HH:mm);关门时间早于开门时间表示跨越午夜。
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。
错误
助手可以修正的调用会返回一个标记为错误的工具结果,以固定代码开头并说明需要更改什么:
invalid_arguments— 参数缺失、超出范围或未知(字段名使用 snake_case),或操作未知。not_found— 没有匹配的已发布企业,或您拥有的企业或地点中没有该记录键。unauthenticated— 该操作需要登录(仅在客户端未对下述 HTTP 401 作出响应时出现)。insufficient_scope— 该连接未被授权执行此操作,例如在只允许读取时尝试更改。
未登录调用 companies 或 locations 会返回 HTTP 401,并附带指向服务器受保护资源元数据的 WWW-Authenticate 标头,助手据此知道要开始登录。超出您允许范围的操作会返回 HTTP 403,附 error=insufficient_scope 及需要申请的权限范围。无效、过期或已撤销的令牌会在任何工具运行前返回 HTTP 401;绝不会被视为没有令牌。请求过多会返回 HTTP 429,并附 Retry-After 标头。
限制
- 每个代理令牌(没有令牌时按 IP 地址计)每分钟 120 次请求。
- 请求正文最大 1024 KB。
- 每次搜索调用最多返回 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
数据与隐私
查询只返回已发布的记录,与企业公开主页上的信息相同。服务器会记录运行了哪个工具和操作、是否成功以及耗时,不记录参数和记录内容。当您连接助手时,to.co 会保存该连接的记录(应用名称、您允许的权限、创建时间和最近使用时间),断开连接后该记录作为安全记录保留。