to.co's MCP-server
Lad en AI-assistent slå udgivne virksomhedsregistreringer op på to.co og holde din egen virksomhedsprofil opdateret. Det er gratis at slå virksomheder op og kræver intet login.
Forbind din assistent Værktøjer
- Server-URL
https://mcp.to.co/mcp- Transport
- Streamable HTTP (MCP-protokolversioner 2026-07-28, 2025-11-25)
Forbind din assistent
Tilføj server-URL'en til din assistent. Opslag virker med det samme. For at lade den administrere dine egne virksomheder skal du logge ind på to.co, når den beder om det, som beskrevet under Login.
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.
Login
Værktøjerne til identitet og hjælp kræver intet login. Værktøjerne til virksomheder og lokationer arbejder med de virksomheder din konto ejer, så assistenten skal handle som dig. Der er to måder.
Log ind med to.co (OAuth). Første gang assistenten bruger værktøjet til virksomheder eller lokationer, svarer serveren at der kræves login, og assistenten åbner en side på to.co, hvor du logger ind og ser hvad den beder om: at læse dine virksomheder og ændre deres offentlige profil. Du kan fravælge ændringer. Den får derefter et token der varer en time og fornyer sig selv; du kan når som helst afbryde forbindelsen på siden Login og sikkerhed. Det virker i assistenter der understøtter MCP-login (OAuth).
Eller brug et agenttoken til scripts og assistenter uden MCP-login. Opret et på siden Login og sikkerhed i my.to.co. Det varer 90 dage, starter med toco_at_, kan alt hvad værktøjerne til virksomheder og lokationer kan, og du kan tilbagekalde det der. Send det som Authorization: Bearer toco_at_…. Behandl det som en adgangskode: tokens afvises fra websider. Uanset hvilken måde kontrollerer serveren ejerskabet ved hvert kald: en anden kontos virksomhed fremstår som ikke fundet.
Administrer forbundne apps og tokens
Hver virksomheds egen server
Hver udgivet virksomhed på to.co har også sin egen MCP-server på sin egen adresse med /mcp til sidst, for eksempel https://mybusiness.uk.to.co/mcp. Det er en anden server end mcp.to.co, med sine egne værktøjer om netop den virksomhed: hvad den udgiver på sin side (hvem den er, hvordan man kontakter den, hvornår og hvor den har åbent, og hvad den lader assistenter gøre), beskeder hvor virksomheden tager imod dem, og værktøjer til ejeren. Ingen af dem slår en anden virksomhed op, og ingen tager imod en adresse. Det er gratis at spørge om virksomheden og kræver ikke login. Hver virksomheds server er dokumenteret på dens egen adresse under /mcp/docs på læserens sprog. Virksomhedens side linker til den, og dens llms.txt og en Link-header (rel="service-desc") peger på dens serverkort, /.well-known/mcp.json.
For at forbinde tilføjer du virksomhedens adresse, der slutter med /mcp, til din assistent som en brugerdefineret connector eller MCP-server. Login fungerer som beskrevet under Login, og forbindelsen gælder kun den virksomhed: et token til en anden virksomhed eller til mcp.to.co bliver afvist. Ejeren finder adressen i my.to.co på virksomhedens fane AI-assistenter.
Det koster ingenting at slå en virksomhed op, med eller uden login: hver kalder (et token, eller en IP-adresse uden token) må lave 600 opslag i timen på hver virksomheds server. Et kald der kræver login, betales af den der laver det. Ejerens konto bruger virksomhedens månedlige API-kreditter på alle abonnementer. Alle andre har deres egen kvote på tværs af alle virksomheder: 60 kald i timen og 500 om måneden. Ud over månedens 500 betaler en virksomhed som deres egen konto har på to.co, med sine månedlige API-kreditter; uden en sådan bliver kald afvist indtil den 1. Afvisninger er HTTP 429: credits_exhausted når virksomhedens måned er brugt op, allowance_exhausted for personens måned og rate_limited med Retry-After for en time.
På Pro og Grow kan ejeren lade assistenter sende virksomheden en besked med værktøjet messages, når den person assistenten handler for, har set beskeden og bedt om at få den sendt med sit eget navn og sine egne kontaktoplysninger. Det er slået fra, indtil ejeren slår det til.
Værktøjer
Hver forbindelse har de fire værktøjer nedenfor; konti der er logget ind, får også værktøjer til dokumenter, handelspartnere og beskeder. Hvert tager et action-argument der siger hvad der skal gøres, plus de argumenter handlingen kræver. Navne på argumenter og resultatfelter er i snake_case ligesom i to.co API. Hvert resultat er JSON, returneret som struktureret indhold med et tilsvarende output-skema. Åbningstider beholder deres gemte form: day (0 for søndag til 6 for lørdag) eller date (YYYY-MM-DD), open, open_time og close_time i 24-timers HH:mm, hvor et lukketidspunkt der er tidligere end åbningstidspunktet, løber over midnat.
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.
| Handling | Hvad den gør | Argumenter | Adgang |
|---|---|---|---|
resolve | The business at a to.co address. |
| Alle Kun læsning |
website | The businesses whose website is on this hostname. A website can belong to more than one business, so this returns a list. |
| Alle Kun læsning |
search | Businesses whose name matches, newest first. |
| Alle Kun læsning |
Eksempel på kald
{
"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.
| Handling | Hvad den gør | Argumenter | Adgang |
|---|---|---|---|
list | Every business the account owns, with its record key and publish status. | Ingen | Login, scope companies:readKun læsning |
get | One business the account owns, by record key. |
| Login, scope companies:readKun læsning |
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. |
| Login, scope companies:writeÆndrer data |
Eksempel på kald
{
"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.
| Handling | Hvad den gør | Argumenter | Adgang |
|---|---|---|---|
list | Every location of a business you own, with its record key, kind (registered or trading), hours, phones and profiles. |
| Login, scope companies:readKun læsning |
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. |
| Login, scope companies:writeÆndrer data |
Eksempel på kald
{
"name": "locations",
"arguments": {
"action": "list",
"domain": "yxpx6pdx.uk.to.co"
}
}
help — Connection and usage help
Check this connection and read the usage guide.
| Handling | Hvad den gør | Argumenter | Adgang |
|---|---|---|---|
whoami | Whether this connection is signed in, and which tools and actions it can use. | Ingen | Alle Kun læsning |
guide | The usage guide as Markdown (also the resource toco://guide). | Ingen | Alle Kun læsning |
Eksempel på kald
{
"name": "help",
"arguments": {
"action": "whoami"
}
}
Ressourcer
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
Prompts
look_up_business— Find a business on to.co by its to.co address, website or name, and summarize its record. Argumenter:business.review_my_profile— Read a business you own and suggest clearer wording for its public profile. Changes nothing until you confirm. Argumenter:domain.
Fejl
Et kald som assistenten kan rette, kommer tilbage som et værktøjsresultat markeret som fejl. Det begynder med en fast kode og siger hvad der skal ændres:
invalid_arguments— Et argument mangler, er uden for det tilladte område eller er ukendt (feltnavne er i snake_case), eller handlingen er ukendt.not_found— Ingen udgivet virksomhed passer, eller ingen virksomhed eller lokation du ejer, har den registreringsnøgle.unauthenticated— Handlingen kræver login (ses kun med klienter der ikke reagerer på HTTP 401 nedenfor).insufficient_scope— Forbindelsen fik ikke lov til denne handling, for eksempel en ændring når kun læsning var tilladt.
Et companies- eller locations-kald uden login får HTTP 401 med en WWW-Authenticate-header der peger på serverens protected resource metadata. Sådan ved assistenten at den skal starte login. En handling uden for det du har tilladt, får HTTP 403 med error=insufficient_scope og det scope der skal bedes om. Et ugyldigt, udløbet eller tilbagekaldt token får HTTP 401 før noget værktøj kører; det bliver aldrig behandlet som intet token. For mange forespørgsler får HTTP 429 med en Retry-After-header.
Grænser
- 120 forespørgsler i minuttet pr. agent-token, eller pr. IP-adresse uden token.
- Forespørgselsindhold op til 1024 KB.
- Søgning returnerer op til 25 virksomheder pr. kald.
Opdagelse
- Serverkort —
https://mcp.to.co/.well-known/mcp.json - Post i MCP Registry (co.to/mcp) —
https://mcp.to.co/server.json - Protected resource metadata (RFC 9728) —
https://mcp.to.co/.well-known/oauth-protected-resource - Metadata for autorisationsserver (RFC 8414) —
https://my.to.co/.well-known/oauth-authorization-server - llms.txt for dette websted
Data og privatliv
Opslag returnerer kun udgivne registreringer, de samme oplysninger som virksomhedens offentlige side. Serveren logger hvilket værktøj og hvilken handling der kørte, om det lykkedes, og hvor lang tid det tog, uden argumenter og uden indhold fra registreringen. Når du forbinder en assistent, gemmer to.co en registrering af forbindelsen (appens navn, hvad du tillod, hvornår den blev oprettet og sidst brugt), som bliver gemt som sikkerhedsregistrering efter du har afbrudt forbindelsen.