Scoris MCP server

Lithuanian company data for your AI assistant

The Scoris MCP server connects Claude, ChatGPT, Cursor and other AI assistants to Lithuanian company data: registry details, finances, employees, debts and ratings. Ask in plain language - the assistant finds the company, returns its data or builds a list of companies that match your criteria.

Sign up for free - 10 company lookups per day
OAuth sign-in No API key Bilingual (LT/EN)

Free for every registered user

A Scoris account is all you need. No paid plan is required - credits are used only for company lists and for lookups above the daily limit.

  • 10 company lookups per day - at any detail level, with contacts if you allowed access to them
  • Company search by name, company code or VAT code
  • Market filter values and the number of companies that match the filters
  • Check your remaining free lookups and credits

The daily limit resets at midnight Lithuanian time.

  • Company lists by market filters - 1 credit per company
  • Company lookups above the daily limit - 1, 2 or 3 credits by detail level
  • For lists the assistant sets a credit ceiling - you are never charged more than you agreed
  • New users get 100 free API credits to try it out

Tools and their cost

The AI assistant chooses which tool to call. Free tools are subject only to a rate limit.

Tool What it does Price
search_companies Finds companies by name, company code or VAT code Free
get_company_profile One company's data: registry details, finances, employees, debts, rating, court cases and more 10 per day free, then 1 / 2 / 3 cr.
list_filter_values Exact market filter values (activities, municipalities and more) Free
count_companies How many companies match the filters Free
list_companies List of companies that match the filters, page by page 1 cr. per company
get_usage_limits Remaining free lookups and credits Free

Company data detail levels

Essentials - 1 cr., Business - 2 cr., Professional - 3 cr. A free daily lookup covers any detail level. If the company is not found, nothing is charged.

Contacts only with your permission

CEO, phone, email and court-case parties are returned only if you grant access to them when you connect. They cost nothing extra.

How to connect

You connect with OAuth: the assistant opens the Scoris sign-in page and you approve access. There is no API key to copy.

Server URL

https://scoris.lt/mcp

Claude (claude.ai and Claude Desktop)

  1. Open Customize → Connectors.
  2. Click "+ Add" → "Add custom connector".
  3. Enter the name Scoris and the server URL.
  4. Sign in to Scoris and approve access.

On Pro and Max plans you add the connector yourself; on Team and Enterprise an organization owner adds it. In a chat, turn it on via "+" → Connectors.

Claude Code

Run in your terminal:

terminal
claude mcp add --transport http scoris https://scoris.lt/mcp

Then type /mcp in a Claude Code session, select scoris and sign in.

ChatGPT

  1. Settings → Apps → Advanced settings: turn on Developer mode.
  2. Apps → Create: enter the name Scoris and the server URL, and choose OAuth for authentication.
  3. Sign in to Scoris, approve access and click Create.

Developer mode availability depends on your ChatGPT plan. On Business and Enterprise accounts an admin turns it on.

Cursor

Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

mcp.json
{"mcpServers":{"scoris":{"url":"https://scoris.lt/mcp"}}}

Cursor opens your browser - sign in to Scoris and approve access.

VS Code

Command Palette → MCP: Open User Configuration (or .vscode/mcp.json in a project) and add:

mcp.json
{"servers":{"scoris":{"type":"http","url":"https://scoris.lt/mcp"}}}

When the server starts, VS Code asks you to sign in to Scoris.

Gemini CLI

Add to ~/.gemini/settings.json:

settings.json
{"mcpServers":{"scoris":{"httpUrl":"https://scoris.lt/mcp"}}}

Then type /mcp auth scoris in Gemini CLI and sign in.

Once connected, try asking:

  • What were Girteka's revenue and profit last year?
  • Does this company owe anything to Sodra or the tax authority (VMI)?
  • How many IT companies in Vilnius have more than 50 employees?

Frequently asked questions

How much does it cost?
Connecting and the free tier cost nothing: search, filter values, company counts and 10 company lookups per day. Credits are used only for company lists and for lookups above the daily limit. API plans start at 39 EUR/month (+ VAT).
Do I need a paid plan?
No. A free Scoris account is enough. You need a paid API plan only for larger company lists or more than 10 company lookups per day.
How fresh is the data?
The data is Scoris's regularly updated copy of Lithuanian public registers, not a live register query. Every answer states its time and links to the company page on scoris.lt. The Scoris rating is a Scoris assessment, not a credit decision.
How is data protected (GDPR)?
You connect with OAuth: the AI assistant never gets your password, only an access token with the permissions you approved. The assistant receives contact and personal data (CEO, phone, email, court-case parties) only if you granted that separate permission. Answers are then processed by the AI assistant you chose, under its own terms. Privacy Policy
How do I disconnect my AI assistant?
Remove the Scoris connector in your AI assistant's settings. If you also want us to revoke the issued access tokens, email us at [email protected].