# Score MCP Quickstart

> Score MCP Quickstart is a freemium MCP server for analytics and data. Minimal MCP server for searching companies through the S.C.A.L.A. Score API. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Repository:** https://github.com/alessandro114/score-mcp-quickstart
- **MCP Registry name:** io.github.Alessandro114/score-mcp-quickstart
- **Categories:** [analytics and data](https://ai-powered.com/categories/analytics-and-data), [sales and CRM](https://ai-powered.com/categories/sales-and-crm)
- **Listing updated:** 2026-11-18

## About

This quickstart is a small stdio server, a single script, that lets an agent search company records through the Score API and see how many credits remain. Its README walks through getting a free key, trying a curl lookup by tax ID, then wiring the script into Claude Desktop or Claude Code.

One detail worth knowing: search results do not carry revenue quality information. To see whether a revenue figure is reported from filed accounts or is a model estimate, along with its confidence, you call the company endpoint. Financials are returned only for France, Norway, Lithuania, Estonia, Latvia and Colombia.

Each call costs one credit. A free key gives 50 calls a month with no card, and one-time packs are listed at 500 credits for 15 euros and 2,000 for 39 euros. Responses include a data licence block whose attribution must be kept if you redistribute the data.

## Features

- **Company search:** Search by name or tax ID with an optional country.
- **Company detail:** Fetch a record including revenue type and confidence.
- **Usage check:** See how many credits you have used.
- **Single script:** One Node file run over stdio.
- **Licence attribution:** Responses include data licence details to keep when redistributing.

## Good for

- Look up a company by tax ID from an agent
- Check whether a revenue figure is reported or estimated
- Test company enrichment before building a pipeline
- Monitor free-tier credit use

## Install

### Claude Code (Terminal)

```sh
claude mcp add score-mcp-quickstart --env SCORE_API_KEY='<SCORE_API_KEY>' -- npx -y score-mcp-quickstart
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "score-mcp-quickstart": {
      "command": "npx",
      "args": [
        "-y",
        "score-mcp-quickstart"
      ],
      "env": {
        "SCORE_API_KEY": "<SCORE_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "score-mcp-quickstart": {
      "command": "npx",
      "args": [
        "-y",
        "score-mcp-quickstart"
      ],
      "env": {
        "SCORE_API_KEY": "<SCORE_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "score-mcp-quickstart": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "score-mcp-quickstart"
      ],
      "env": {
        "SCORE_API_KEY": "<SCORE_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "score-mcp-quickstart": {
      "command": "npx",
      "args": [
        "-y",
        "score-mcp-quickstart"
      ],
      "env": {
        "SCORE_API_KEY": "<SCORE_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "score-mcp-quickstart": {
      "command": "npx",
      "args": [
        "-y",
        "score-mcp-quickstart"
      ],
      "env": {
        "SCORE_API_KEY": "<SCORE_API_KEY>"
      }
    }
  }
}
```

## Tools

- `search_companies`: Search by name or tax ID with optional country
- `get_company`: Get one company record
- `get_usage`: Show API usage

## FAQ

### Is there a free tier?

Yes, 50 calls per month with no card.

### What do extra credits cost?

One-time packs: 500 credits for 15 euros and 2,000 for 39 euros, with no subscription.

### Which countries have financial data?

France, Norway, Lithuania, Estonia, Latvia and Colombia.

### What does each call cost?

One credit.

### Is Score MCP Quickstart free?

Score MCP Quickstart has a free plan, with paid plans for more usage or features.

### How do I add Score MCP Quickstart to Claude Code?

Run this command in your terminal: claude mcp add score-mcp-quickstart --env SCORE_API_KEY='<SCORE_API_KEY>' -- npx -y score-mcp-quickstart

### What are the best alternatives to Score MCP Quickstart?

The closest alternatives to Score MCP Quickstart are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, dashboard-icons, Tapetide - Indian Stock Market MCP and World Monitor.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [dashboard-icons](https://ai-powered.com/mcp/dashboard-icons): dashboard-icons is an open-source MCP server for analytics and data.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Maildignity](https://ai-powered.com/mcp/maildignity-2): Maildignity is a freemium MCP server for sales and crm.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [DataArcus for Power BI](https://ai-powered.com/mcp/dataarcus-for-power-bi): DataArcus for Power BI is a free MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/score-mcp-quickstart
