quickstart

Connect an agent in three steps.

ImonesMCP is a remote MCP server over Streamable HTTP. Any MCP client can use it — Claude, Cursor, or your own agent.

1

Sign in with OAuth or create an API key

Most MCP clients open a browser sign-in automatically (OAuth) — no key needed. For automation or CI, generate a key from your dashboard. Keys look like rk_live_… and are shown once — store it somewhere safe.

2

Add the server to your MCP client

Point your client at the endpoint. OAuth clients need no header; with an API key, send it as a bearer token. Pick your agent:

endpoint
run in your terminal
claude mcp add --transport http imonesmcp https://api.imonesmcp.lt/mcp

No key needed — after adding the server, /mcp opens your browser to sign in (OAuth). For CI, use an API key with --header.

3

Ask your agent

The agent discovers the tools automatically. Try a real question:

"Find active Vilnius logistics companies with over
 €1M revenue and VAT registered, sorted by revenue."

tool reference

Six tools

search_companies

Search with filters: query (fuzzy name/code/VAT), activityCode or activityDivision, municipality, vatActive, minRevenue/maxRevenue, registeredAfter/Before, sort, limit, offset.

get_company

Full profile by code (ja_kodas) or vatCode — legal form, status, VAT, primary activity, municipality, latest revenue.

get_company_financials

Yearly summary (revenue, pre-tax and net profit, assets, equity) plus raw statement line items. Argument: code.

get_company_people

Aggregate ownership counts (LT/foreign, natural/legal). No named individuals. Argument: code.

resolve_activity_code

Look up EVRK sections/divisions by code (or prefix) or free-text query.

aggregate_companies

Count companies grouped by activityDivision, municipality, legalForm, or status, with optional filters.

Attribution

All responses derive from official Lithuanian open data (VĮ Registrų centras / data.gov.lt), licensed under CC BY 4.0. When you publish results, attribute the source.