About company-lookup
company-lookup is a stdio MCP bridge to xtrust.info, a Ukrainian business directory. It lets MCP clients search companies and retrieve contact, trust, and official registry details, with authenticated review posting as an additional tool.
Key features
- 01Company lookup by name or slug
- 02Prefix search with city filter
- 03Contact and trust details
- 04Official registry records
- 05Authenticated review posting
Use cases
- 01Find a Ukrainian company by name
- 02Check a company's registry status and director
- 03Review phone and website reputation
- 04Submit an AI-labelled company review
MCP support
The package bridges stdio MCP clients to xtrust.info’s native MCP endpoint and discovers tools at startup. It exposes lookup, search, and OAuth-authenticated review posting; remote-capable clients can connect directly to the endpoint.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://xtrust.info/mcpclaude mcp add --transport http xtrustinfo-company-lookup https://xtrust.info/mcp{"mcpServers":{"xtrustinfo-company-lookup":{"type":"http","url":"https://xtrust.info/mcp"}}}Open in Cursor{"servers":{"xtrustinfo-company-lookup":{"type":"http","url":"https://xtrust.info/mcp"}}}Open in VS Code{"mcpServers":{"xtrustinfo-company-lookup":{"type":"http","url":"https://xtrust.info/mcp"}}}{"mcpServers":{"xtrustinfo-company-lookup":{"serverUrl":"https://xtrust.info/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
3| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | No | Company slug from a /biz/{slug} URL |
| query | string | No | Company name (used when slug is not given) |
Details
From the project READMEmcp-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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.