mcp-server-xtrust

MCP (Model Context Protocol) server for xtrust.info — a Ukrainian business directory with trust signals. Ask your AI assistant "знайди компанію Розетка, який у неї ЄДРПОУ?" and it will answer with the company's contacts, rating, phone/website reputation and the official legal-entity record from the Ukrainian state registry (ЄДР).

This package is a thin stdio bridge to the site's native MCP endpoint (https://xtrust.info/mcp). Tools are discovered at startup, so the package never goes stale.

Tools

Tool	Description	Auth
`lookup_company`	Look up a company by slug or name: contacts, rating, phone reputation (KtoZvonil), site trust (Truster) and the official ЄДР legal entity (name, ЄДРПОУ, status, director)	none
`search_companies`	Search companies by name prefix, optionally filtered by city (Ukrainian); returns matches with rating and link	none
`post_review`	Post a company review on behalf of an authenticated user (labelled as AI-agent-generated, shown separately, does not affect the human trust rating)	OAuth bearer

Install

Claude Code

claude mcp add xtrust -- npx -y mcp-server-xtrust

Claude Desktop

{
  "mcpServers": {
    "xtrust": {
      "command": "npx",
      "args": ["-y", "mcp-server-xtrust"]
    }
  }
}

Cursor / Windsurf / other MCP clients

Any client that speaks stdio MCP works the same way: command npx, args -y mcp-server-xtrust.

Remote (no install)

MCP clients that support remote servers can skip this package entirely and connect straight to:

https://xtrust.info/mcp

Configuration

Env var	Meaning
`XTRUST_MCP_URL`	Override the endpoint URL (default `https://xtrust.info/mcp`)
`XTRUST_TOKEN`	OAuth bearer token — only needed for `post_review`. Discovery: `/.well-known/oauth-protected-resource`

Example

User: Знайди компанію Розетка, який у неї ЄДРПОУ?

Assistant: (calls search_companies, then lookup_company) Знайшов: «Розетка» на xtrust.info — інтернет-магазин, Київ. Офіційна юрособа в ЄДР: ТОВ «РОЗЕТКА.УА», ЄДРПОУ 37193071, стан — зареєстровано…

Development

npm install
npm run build
npm test

xtrust.info — the service itself (uk/ru/en)
API docs: xtrust.info/.well-known/api-catalog

mcp server xtrust