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 Verktøy
- Server-URL
https://mcp.to.co/mcp- Transport
- Streamable HTTP (MCP-protokollversjoner 2026-07-28, 2025-11-25)
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)
- 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.
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
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å.
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.
| Handling | Hva den gjør | Argumenter | Tilgang |
|---|---|---|---|
resolve | The business at a to.co address. |
| Alle Bare lesing |
website | The businesses whose website is on this hostname. A website can belong to more than one business, so this returns a list. |
| Alle Bare lesing |
search | Businesses whose name matches, newest first. |
| Alle Bare lesing |
Eksempel på kall
{
"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 | Hva den gjør | Argumenter | Tilgang |
|---|---|---|---|
list | Every business the account owns, with its record key and publish status. | Ingen | Innlogging, omfang companies:readBare lesing |
get | One business the account owns, by record key. |
| Innlogging, omfang companies:readBare lesing |
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. |
| Innlogging, omfang companies:writeEndrer data |
Eksempel på kall
{
"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 | Hva den gjør | Argumenter | Tilgang |
|---|---|---|---|
list | Every location of a business you own, with its record key, kind (registered or trading), hours, phones and profiles. |
| Innlogging, omfang companies:readBare lesing |
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. |
| Innlogging, omfang companies:writeEndrer data |
Eksempel på kall
{
"name": "locations",
"arguments": {
"action": "list",
"domain": "yxpx6pdx.uk.to.co"
}
}
help — Connection and usage help
Check this connection and read the usage guide.
| Handling | Hva den gjør | Argumenter | Tilgang |
|---|---|---|---|
whoami | Whether this connection is signed in, and which tools and actions it can use. | Ingen | Alle Bare lesing |
guide | The usage guide as Markdown (also the resource toco://guide). | Ingen | Alle Bare lesing |
Eksempel på kall
{
"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 - llms.txt for dette nettstedet
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.