Score Mcp Quickstart

io.github.Alessandro114Published by GitHub account Alessandro114v0.1.1Updated Oct 29, 2026

Company data for AI agents: search 249M+ companies via the S.C.A.L.A. Score API.

VerifiedSTDIODesktop onlyFinance Business & Commerce

Server details

Identifier: io.github.Alessandro114/score-mcp-quickstart
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Oct 26, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account Alessandro114 for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.Alessandro114%2Fscore-mcp-quickstart.svg)](https://sourceweft.com/mcp/io.github.Alessandro114%2Fscore-mcp-quickstart?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Local stdio MCP server that lets an assistant search 249M+ companies and pull company profiles through the S.C.A.L.A. Score API.

What you can do: Search companies by name prefix or tax/VAT id, optionally filtered by country
Fetch a full company profile by id, including revenue type, revenue confidence and source
Check the remaining API credits for the configured key
When to use it: Useful when an assistant needs company lookup, tax-id resolution or basic financial context about businesses, for example in research, sales or compliance-style checks. Each lookup consumes paid credits, so it suits occasional lookups rather than bulk enrichment.
Requirements: Runs as a local Node.js process over stdio; the README shows a manual setup with the MCP SDK and zod rather than a ready-made package entry point. Requires a SCORE_API_KEY environment variable, obtainable as a free key with 50 calls per month. Network access to the Score API is needed.

Before you install

Every search or profile call costs 1 credit, and paid credit packs are one-time purchases, so usage spends money. The API key is passed as an environment variable and should be kept private. Financial data is only returned for FR, NO, LT, EE, LV and CO, and redistributed data must keep the data_licences attribution.

Installation

In SourceWeft

Open Score Mcp Quickstart in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Quickstart: company data for your AI agent in 5 minutes

Get a free key (50 calls/month, no card): https://score.get-scala.com/api/free-key
Try it:

bash

export SCORE_API_KEY=sk_score_...curl -H "X-API-Key: $SCORE_API_KEY" "https://score.get-scala.com/api/v1/search?tax_id=IT00159560366&limit=1"curl -H "X-API-Key: $SCORE_API_KEY" "https://score.get-scala.com/api/v1/usage"

export SCORE_API_KEY=sk_score_...curl -H "X-API-Key: $SCORE_API_KEY" "https://score.get-scala.com/api/v1/search?tax_id=IT00159560366&limit=1"curl -H "X-API-Key: $SCORE_API_KEY" "https://score.get-scala.com/api/v1/usage"

Know what you get: call /api/v1/company/{id} and read revenue_type (reported = filed accounts, estimated = model estimate) and revenue_confidence. Search results alone don't carry it.
Give it to your agent (MCP, stdio):

Claude Desktop / Claude Code config: {"mcpServers":{"score":{"command":"node","args":["/path/mcp-score.mjs"],"env":{"SCORE_API_KEY":"sk_score_..."}}}} Tools: search_companies (name or tax id, optional country), get_company, get_usage. Each call = 1 credit. Free key: 50/month. Paid packs: one-time credits (500 = €15, 2,000 = €39), no subscription. Redistribution: keep the data_licences attribution.

Data licences: responses include a data_licences block; keep the attribution when you redistribute data. Financials are returned only for FR, NO, LT, EE, LV, CO.

API documentation, plans and keys: https://score.get-scala.com/api/?utm_source=github&utm_medium=readme&utm_campaign=mcp

Source: README.md at commit 1135b85

Tools

search_companies

Search companies by name (prefix match) or by tax/VAT id. 1 credit per call. Check revenue_type: 'reported' = filed accounts, 'estimated' = model estimate.

Parametersqlimittax_idcountry

get_company

Full profile for a company id returned by search_companies (includes revenue_type, revenue_confidence, source). 1 credit.

Parametersidrequired

get_usage

Remaining credits for this key (free).

Takes no parameters.

Version history

v0.1.1LatestOct 26, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listedRequired15 pts
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts