to.co forside

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)

  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.

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.

HandlingHvad den gørArgumenterAdgang
resolveThe business at a to.co address.
  • host string, påkrævet A to.co address, e.g. mybusiness.uk.to.co or mybusiness-bristol.biz.to.co
Alle
Kun læsning
websiteThe businesses whose website is on this hostname. A website can belong to more than one business, so this returns a list.
  • website string, påkrævet The business's own website, e.g. mybusiness.com or https://www.mybusiness.com/
Alle
Kun læsning
searchBusinesses whose name matches, newest first.
  • query string, påkrævet Part of the business name, at least 2 characters
  • limit integer Maximum results, 1-25 (default 10)
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.

HandlingHvad den gørArgumenterAdgang
listEvery business the account owns, with its record key and publish status.IngenLogin, scope companies:read
Kun læsning
getOne business the account owns, by record key.
  • domain string, påkrævet The record key of a company you own, as returned by companies list (the `domain` field)
Login, scope companies:read
Kun læsning
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, påkrævet 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
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.

HandlingHvad den gørArgumenterAdgang
listEvery location of a business you own, with its record key, kind (registered or trading), hours, phones and profiles.
  • domain string, påkrævet The record key of a company you own, as returned by companies list (the `domain` field)
Login, scope companies:read
Kun læsning
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, påkrævet The record key of a company you own, as returned by companies list (the `domain` field)
  • location string, påkrævet 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
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.

HandlingHvad den gørArgumenterAdgang
whoamiWhether this connection is signed in, and which tools and actions it can use.IngenAlle
Kun læsning
guideThe usage guide as Markdown (also the resource toco://guide).IngenAlle
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

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.

Næste skridt

Sprog

Vælg blandt de sprog som hjemmesiden og appen understøtter fuldt ud.