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, thenlookup_company) Знайшов: «Розетка» на xtrust.info — інтернет-магазин, Київ. Офіційна юрособа в ЄДР: ТОВ «РОЗЕТКА.УА», ЄДРПОУ 37193071, стан — зареєстровано…
Development
npm install
npm run build
npm test
Related
- xtrust.info — the service itself (uk/ru/en)
- API docs: xtrust.info/.well-known/api-catalog
License
MIT © xtrust.info