Documentation

API and MCP.

TORIN has its own API under /v1/ and an MCP server under /mcp, so you can plug it into the tools you already use, including Claude and ChatGPT.

Join the waitlist List of endpoints

Accounts open on 1 December 2026. Join the list and we will email you once.

APIkey scopes/v1/

conversation7 endpoints
read6 endpoints
files3 endpoints
usage2 endpoints
any, log1 endpoint each

First call

Your credit balance in one request.

You create the key in your agency settings and can revoke it at any time. Send it in the Authorization or x-api-key header.

Request

curl https://app.hiretorin.com/v1/credits \
  -H "Authorization: Bearer $TORIN_API_KEY"

Response (sample values)

{
  "object": "credits",
  "balance": 240,
  "buckets": {
    "carried_over": 0,
    "plan": 240,
    "topped_up": 0
  },
  "tier": "probny",
  "period": "2026-11",
  "included_in_tier": 2000,
  "renews_on": "2026-12-01",
  "grosz_per_credit": 1,
  "low": false,
  "note": "240 credits left (worth 2.40 PLN)."
}

Counted from the product on 2 November 202613 response fields

Claude and ChatGPT

The MCP server.

A change to a client's account made through the API or MCP becomes a proposal, not an action: the same approvals apply as in the app.

MCP server address:  https://app.hiretorin.com/mcp
Sign-in:             OAuth (the connector finds the
                     authorization server under /.well-known/)
Scope:               read (id: czytaj); change tools create proposals

Endpoints

What the API offers.

Method	Path	Key scope	What it does
`GET`	`/v1/models`	any `dowolny`	models you can order
`GET`	`/v1/credits`	usage `zuzycie`	the agency's credit balance
`GET`	`/v1/usage`	usage `zuzycie`	usage over a period
`POST`	`/v1/chat/completions`	conversation `rozmowa`	a question in an OpenAI-compatible format
`POST`	`/v1/messages`	conversation `rozmowa`	a question in an Anthropic-compatible format
`POST`	`/mcp`	read `czytaj`	MCP server (read tools)
`GET`	`/v1/threads`	read `czytaj`	the agency's conversations
`GET`	`/v1/threads/{id}`	read `czytaj`	a single conversation
`POST`	`/v1/threads`	conversation `rozmowa`	a new conversation
`POST`	`/v1/threads/{id}/messages`	conversation `rozmowa`	a message in a conversation
`GET`	`/v1/runs`	read `czytaj`	work runs
`GET`	`/v1/runs/{id}`	read `czytaj`	a single run
`POST`	`/v1/runs`	conversation `rozmowa`	a job to run in the background
`POST`	`/v1/runs/{id}/decyzja`	conversation `rozmowa`	a decision in a run that is waiting for one
`POST`	`/v1/runs/{id}/anuluj`	conversation `rozmowa`	stopping a run
`GET`	`/v1/tools`	read `czytaj`	tools, and which of them need approval
`GET`	`/v1/files`	files `pliki`	files from conversations
`GET`	`/v1/files/{id}`	files `pliki`	a single file
`POST`	`/v1/files/{id}/link`	files `pliki`	a link to a file, valid for fifteen minutes
`GET`	`/v1/audit`	log `dziennik`	the agency's event log

Counted from the product on 2 November 202620 endpoints

Tests

How we check it.

Every module has its own offline test suite. The full run happens with network access blocked, so no test depends on anyone else's API.

264: suites
361,540: checks
0: attempts to reach the network

Counted from the product on 31 October 2026last full run, all green

Try it on one client's account.

No card and no password. The trial plan is €4.58 net of Torin's work.

Join the waitlist See pricing