Model Context Protocol

A live remote MCP endpoint that gives supported LLM clients read-only access to the Varosyan Global Corporate Index.

Endpoint

Add this server to any MCP client that supports remote Streamable HTTP:

https://varosyanllc.com/api/public/mcp

Company data requires an account key. A free key returns standard company and corporate contact fields at 100 requests a day. Premium returns full records at 5,000 requests a day. Create one on API keys.

Client configuration

{
  "mcpServers": {
    "varosyan": {
      "type": "http",
      "url": "https://varosyanllc.com/api/public/mcp",
      "headers": { "Authorization": "Bearer vk_live_..." }
    }
  }
}

Available tools

search_companies
Search by name, country, classification, city, legal form and record completeness.
get_company
Retrieve one record with details, branches, people, events and signals.
list_countries
Indexed countries and their coverage state.
list_categories
Classifications with record counts.
coverage_summary
Index totals for records, countries and classifications.

Check the connection

Confirm the endpoint before configuring a client. The first call lists the tools your assistant will see; the second runs a live search.

Service health

Public APIChecking
Checking
Agent endpointChecking
Checking

Running the first check

List tools

Call a tool

A failing call returns a JSON-RPC error object with a code and a plain message. Codes in the 401 and 403 range mean the key is missing, revoked or not on a Premium plan; 429 means the hourly quota is spent and the call succeeds again after the window resets.

Security model

The endpoint is read-only: no tool writes, deletes or changes index data. Keys are stored only as hashes, results are bounded, quotas are enforced per key and every call is logged with a request identifier. Revoking a key in your account blocks it immediately.