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

# MCP-serveren til to.co

La en AI-assistent slå opp publiserte bedriftsoppføringer på to.co, og holde din egen bedriftsprofil oppdatert. Det er gratis å slå opp bedrifter, og det krever ingen innlogging.

[Koble til assistenten din](#connect) · [Verktøy](#tools)

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

<a id="connect"></a>
## Koble til assistenten din

Legg til server-URL-en i assistenten din. Oppslag virker med en gang. For å la den administrere dine egne bedrifter logger du inn på to.co når den ber om det, som beskrevet under «Innlogging».

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

## Innlogging

Verktøyene for identitet og hjelp krever ingen innlogging. Verktøyene for selskaper og steder virker på bedriftene kontoen din eier, så assistenten må handle som deg. Det finnes to måter.

Logg inn med to.co (OAuth). Når assistenten første gang bruker verktøyet for selskaper eller steder, svarer serveren at den krever innlogging, og assistenten åpner en side på to.co der du logger inn og ser hva den ber om: å lese bedriftene dine og å endre den offentlige profilen deres. Du kan fjerne merket for endringer. Assistenten får da et token som varer i en time og fornyer seg selv. Du kan koble det fra når som helst på siden «Innlogging og sikkerhet». Dette virker i assistenter som støtter MCP-innlogging (OAuth).

Du kan også bruke et agent-token, for skript og assistenter uten MCP-innlogging. Opprett et på siden «Innlogging og sikkerhet» i my.to.co. Det varer i 90 dager, begynner med toco_at_, kan gjøre alt verktøyene for selskaper og steder kan, og du kan tilbakekalle det der. Send det som Authorization: Bearer toco_at_…. Behandle det som et passord: tokener avvises fra nettsider. Uansett hvilken måte du velger, kontrollerer serveren eierskapet ved hvert kall: en annen kontos bedrift gir «ikke funnet».

[Administrer tilkoblede apper og tokener](https://my.to.co/account/security)

<a id="business"></a>
## Hver bedrifts egen server

Hver publiserte bedrift på to.co har også sin egen MCP-server, på sin egen adresse med /mcp til slutt, for eksempel https://mybusiness.uk.to.co/mcp. Det er en egen server, atskilt fra mcp.to.co, med egne verktøy om akkurat den ene bedriften: det den publiserer på siden sin (hvem den er, hvordan du når den, når og hvor den har åpent, og hva den lar assistenter gjøre), meldinger der bedriften tar imot dem, og verktøy for eieren. Ingen av dem slår opp en annen bedrift, og ingen tar imot en adresse. Det er gratis å spørre om bedriften og krever ingen innlogging. Serveren til hver bedrift er dokumentert på bedriftens egen adresse, på /mcp/docs, på leserens språk. Bedriftens side lenker til den, og llms.txt og en Link-header (rel="service-desc") peker til serverkortet, /.well-known/mcp.json.

For å koble til legger du til bedriftens adresse, som slutter på /mcp, i assistenten din som en egendefinert kobling eller MCP-server. Innlogging fungerer som beskrevet under Innlogging, og tilkoblingen gjelder bare den bedriften: et token for en annen bedrift, eller for mcp.to.co, blir avvist. Eieren finner adressen på my.to.co, i fanen AI-assistenter for bedriften.

Det koster ingenting å slå opp en bedrift, enten du er logget inn eller ikke: hver avsender (et token, eller en IP-adresse uten token) kan gjøre 600 oppslag i timen på serveren til hver bedrift. Et kall som krever innlogging, betales av den som gjør det. Eierens konto bruker bedriftens månedlige API-kreditter, på alle abonnementer. Alle andre har en egen kvote på tvers av alle bedrifter: 60 kall i timen og 500 i måneden. Etter månedens 500 betaler en bedrift som kontoen deres har på to.co, fra sine månedlige API-kreditter; uten en slik bedrift avvises kall frem til den 1. i måneden. Avvisninger er HTTP 429: credits_exhausted når bedriftens måned er brukt opp, allowance_exhausted for personens måned, og rate_limited med Retry-After for en time.

På Pro og Grow kan eieren la assistenter sende bedriften en melding med verktøyet messages, når personen assistenten handler for, har sett meldingen og bedt om at den sendes, med sitt eget navn og sine egne kontaktopplysninger. Dette er av til eieren slår det på.

<a id="tools"></a>
## Verktøy

Hver tilkobling har de fire verktøyene nedenfor; innloggede kontoer får også verktøy for dokumenter, handelspartnere og meldinger. Hvert av dem tar et action-argument som sier hva som skal gjøres, pluss argumentene den handlingen trenger. Navn på argumenter og resultatfelt skrives i snake_case, som i to.co-API-et. Alle resultater er JSON, returnert som strukturert innhold med et tilhørende utdataskjema. Åpningstider beholder sin lagrede 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, der en stengetid tidligere enn åpningstiden går over midnatt.

### `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, bare lesing): The business at a to.co address.
  - `host` (string, påkrevd): A to.co address, e.g. mybusiness.uk.to.co or mybusiness-bristol.biz.to.co
- `website` (alle, bare lesing): 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åkrevd): The business's own website, e.g. mybusiness.com or https://www.mybusiness.com/
- `search` (alle, bare lesing): Businesses whose name matches, newest first.
  - `query` (string, påkrevd): Part of the business name, at least 2 characters
  - `limit` (integer): Maximum results, 1-25 (default 10)

Eksempel på kall:

```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` (innlogging, omfang `companies:read`, bare lesing): Every business the account owns, with its record key and publish status.
- `get` (innlogging, omfang `companies:read`, bare lesing): One business the account owns, by record key.
  - `domain` (string, påkrevd): The record key of a company you own, as returned by companies list (the `domain` field)
- `update` (innlogging, omfang `companies:write`, endrer 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åkrevd): 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å kall:

```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` (innlogging, omfang `companies:read`, bare lesing): Every location of a business you own, with its record key, kind (registered or trading), hours, phones and profiles.
  - `domain` (string, påkrevd): The record key of a company you own, as returned by companies list (the `domain` field)
- `update` (innlogging, omfang `companies:write`, endrer 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åkrevd): The record key of a company you own, as returned by companies list (the `domain` field)
  - `location` (string, påkrevd): 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å kall:

```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, bare lesing): Whether this connection is signed in, and which tools and actions it can use.
- `guide` (alle, bare lesing): The usage guide as Markdown (also the resource toco://guide).

Eksempel på kall:

```json
{
  "name": "help",
  "arguments": {
    "action": "whoami"
  }
}
```

## Ressurser

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

## Ledetekster

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

## Feil

Et kall assistenten kan rette, kommer tilbake som et verktøyresultat merket som feil, som starter med en fast kode og sier hva som må endres:

- `invalid_arguments`: Et argument mangler, er utenfor gyldig område eller er ukjent (feltnavn skrives i snake_case), eller handlingen er ukjent.
- `not_found`: Ingen publisert bedrift samsvarer, eller ingen bedrift eller sted du eier, har den oppføringsnøkkelen.
- `unauthenticated`: Handlingen krever innlogging (vises bare med klienter som ikke reagerer på HTTP 401 nedenfor).
- `insufficient_scope`: Tilkoblingen har ikke tillatelse til denne handlingen, for eksempel en endring når bare lesing var tillatt.

Et companies- eller locations-kall uten innlogging får HTTP 401 med en WWW-Authenticate-header som peker til serverens metadata for beskyttet ressurs, og slik vet assistenten at den skal starte innlogging. En handling utenfor det du har tillatt, får HTTP 403 med error=insufficient_scope og omfanget det må bes om. Et ugyldig, utløpt eller tilbakekalt token får HTTP 401 før noe verktøy kjører; det behandles aldri som manglende token. For mange forespørsler får HTTP 429 med en Retry-After-header.

## Grenser

- 120 forespørsler i minuttet per agenttoken, eller per IP-adresse uten token.
- Forespørselsinnhold på opptil 1024 KB.
- Søk returnerer opptil 25 bedrifter per kall.

## Oppdagelse

- Serverkort: https://mcp.to.co/.well-known/mcp.json
- Oppføring i MCP Registry (co.to/mcp): https://mcp.to.co/server.json
- Metadata for beskyttet ressurs (RFC 9728): https://mcp.to.co/.well-known/oauth-protected-resource
- Metadata for autorisasjonsserver (RFC 8414): https://my.to.co/.well-known/oauth-authorization-server

## Data og personvern

Oppslag returnerer bare publiserte oppføringer, de samme opplysningene som bedriftens offentlige side. Serveren logger hvilket verktøy og hvilken handling som kjørte, om det fungerte og hvor lang tid det tok, uten argumenter og uten innhold fra oppføringer. Når du kobler til en assistent, lagrer to.co en oversikt over tilkoblingen (appens navn, hva du tillot, når den ble opprettet og sist brukt), som blir liggende som en sikkerhetsoppføring etter at du kobler den fra.

## Neste steg

- [Les lanseringsinnlegget](https://to.co/en-us/blog/mcp-server)
- [Kom i gang](https://my.to.co/claim)
