**MCP-server** · [API](https://to.co/da-dk/docs/api?format=md)

# 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](#connect) · [Værktøjer](#tools)

- Server-URL: `https://mcp.to.co/mcp`
- Transport: Streamable HTTP (MCP-protokolversioner 2026-07-28, 2025-11-25)

<a id="connect"></a>
## 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.

```sh
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.

```json
{
  "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.

```json
{
  "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.

```json
{
  "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](https://my.to.co/account/security)

<a id="business"></a>
## 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.

<a id="tools"></a>
## 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.

- `resolve` (alle, kun læsning): The 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
- `website` (alle, kun læsning): The 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/
- `search` (alle, kun læsning): Businesses 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)

Eksempel på kald:

```json
{
  "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` (login, scope `companies:read`, kun læsning): Every business the account owns, with its record key and publish status.
- `get` (login, scope `companies:read`, kun læsning): One 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)
- `update` (login, scope `companies:write`, ændrer data): 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.
  - `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

Eksempel på kald:

```json
{
  "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` (login, scope `companies:read`, kun læsning): Every 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)
- `update` (login, scope `companies:write`, ændrer data): 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.
  - `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

Eksempel på kald:

```json
{
  "name": "locations",
  "arguments": {
    "action": "list",
    "domain": "yxpx6pdx.uk.to.co"
  }
}
```

### `help` — Connection and usage help

Check this connection and read the usage guide.

- `whoami` (alle, kun læsning): Whether this connection is signed in, and which tools and actions it can use.
- `guide` (alle, kun læsning): The usage guide as Markdown (also the resource toco://guide).

Eksempel på kald:

```json
{
  "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

## 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

- [Læs lanceringsindlægget](https://to.co/en-us/blog/mcp-server)
- [Kom i gang](https://my.to.co/claim)
