mcpField
S
score-mcp-quickstart

score-mcp-quickstart

Local
github.com/Alessandro114Business & Marketing0Updated 5d ago
Repository

About score-mcp-quickstart

score-mcp-quickstart is a guide and MCP server setup for searching company data through the S.C.A.L.A. Score API. Its tools search companies, retrieve company records, and check API usage; the guide also explains revenue estimates and data attribution.

Key features

  1. 01Search companies by name or tax ID
  2. 02Retrieve company records
  3. 03Check API usage
  4. 04Distinguish reported and estimated revenue

Use cases

  1. 01Find a company by name or tax ID
  2. 02Retrieve a company’s detailed record
  3. 03Check remaining API usage
  4. 04Preserve attribution when redistributing data

MCP support

The quickstart describes a stdio MCP server with `search_companies`, `get_company`, and `get_usage` tools. It gives configuration guidance for Claude Desktop and Claude Code.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "alessandro114-score-mcp-quickstart": {
      "command": "npx",
      "args": [
        "-y",
        "score-mcp-quickstart"
      ],
      "env": {
        "SCORE_API_KEY": "<SCORE_API_KEY>"
      }
    }
  }
}
Run commandnpx -y score-mcp-quickstart
Environment variables to set
SCORE_API_KEYSecretFree key from https://score.get-scala.com/api/free-key

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmscore-mcp-quickstart0.1.1

Tools

3

Saved tool list · updated 3d ago

ParameterTypeRequiredDescription
qstringNo
limitintegerNo
tax_idstringNo
countrystringNo

Details

From the project README

Quickstart: company data for your AI agent in 5 minutes

  1. Get a free key (50 calls/month, no card): https://score.get-scala.com/api/free-key
  2. Try it:
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"
  1. 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.
  2. Give it to your agent (MCP, stdio):
npm i @modelcontextprotocol/sdk zod
SCORE_API_KEY=sk_score_... node mcp-score.mjs

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

Comments

Markdown supported

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.