S.C.A.L.A. MCP Server

An MCP server that gives Claude, ChatGPT, Codex, and any MCP-compatible AI agent access to the S.C.A.L.A. Score company intelligence database -- 250M+ companies across 50+ countries.

Quick Start

npx -y scala-mcp-server

That's it. One command. Set your API key and go:

SCALA_API_KEY=your-key npx -y scala-mcp-server

Get a free API key at app.get-scala.com -- no credit card required.

What It Does

Once connected, your AI assistant can:

• Search companies by name, VAT number, keyword -- across 50+ countries
• Lookup detailed company profiles (revenue, employees, health score, industry)
• Generate reports (financial health, risk assessment, due diligence)
• Explore the database -- stats, country coverage, credit balance

Setup

Smithery (Recommended)

Install automatically via Smithery:

npx @smithery/cli mcp add Alessandro114/scala-mcp-server --config '{"scalaApiKey":"your-api-key"}'

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "scala-score": {
      "command": "npx",
      "args": ["-y", "scala-mcp-server"],
      "env": {
        "SCALA_API_KEY": "your-api-key"
      }
    }
  }
}

{
  "mcpServers": {
    "scala-score": {
      "command": "npx",
      "args": ["-y", "scala-mcp-server"],
      "env": {
        "SCALA_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

claude mcp add scala-score -e SCALA_API_KEY=your-key -- npx -y scala-mcp-server

Any MCP Client

SCALA_API_KEY=your-key npx -y scala-mcp-server

Or install globally:

npm install -g scala-mcp-server
SCALA_API_KEY=your-key scala-mcp

Tools

| Tool | Description | Credits | |------|-------------|---------| | search_companies | Search by name, VAT, keyword with country/NACE/status filters | 1 | | lookup_company | Full company profile by ID or VAT number | 1 | | company_report | Health report -- basic (5), pro (10), enterprise (20) | 5-20 | | database_stats | Total companies, countries, last update | 0 | | list_countries | All countries with company counts | 0 | | check_credits | Remaining credits, plan info, reset date | 0 |

Demo

Here's what a real conversation looks like:

You: Find the top 10 restaurant chains in Italy

Claude: uses search_companies with query="ristorante catena", country="IT", nace="56.10"

I found 10 restaurant chains in Italy. Here are the largest by revenue:

| # | Company | Revenue | Employees | Health | |---|---------|---------|-----------|--------| | 1 | AUTOGRILL S.P.A. | EUR 3.2B | 12,400 | 82/100 | | 2 | CHEF EXPRESS S.P.A. | EUR 890M | 4,200 | 78/100 | | ... | | | | |

You: Look up Ferrero's financial health

Claude: uses lookup_company with company_id="IT02727330014"

Ferrero International S.A.

• Revenue: EUR 17.0B
• Employees: 41,000+
• Health Score: 94/100
• NACE: 10.82 (Cocoa, chocolate and sugar confectionery)
• Status: Active since 1946

You: Compare construction companies in Milan vs Munich

Claude: uses search_companies twice with country="IT"/country="DE" and nace="41"

Milan has 3x more construction companies, but Munich firms average 40% higher revenue. Health scores are comparable (avg 68 vs 71).

Get Your API Key

1. Sign up at app.get-scala.com
2. Navigate to Score > API
3. Generate your key
4. Set SCALA_API_KEY as environment variable

Free tier includes credits to get started -- no credit card required.

Pricing

| Plan | Credits/mo | Best for | |------|-----------|----------| | Free | 50 | Testing, evaluation | | Starter | 500 | Personal projects | | Growth | 5,000 | Regular lookups | | Enterprise | 50,000+ | Bulk analysis, integrations |

See get-scala.com/score for current pricing.

How It Works

Your AI Assistant  <-->  MCP Protocol  <-->  scala-mcp-server  <-->  S.C.A.L.A. Score API
                                                                          |
                                                                    250M+ companies
                                                                    50+ countries
                                                                    NACE industry codes
                                                                    Financial data

The server communicates over stdio using the Model Context Protocol. No HTTP server, no ports, no configuration beyond the API key.

Contributing

Contributions are welcome! Here's how:

1. Fork the repository
2. Create your feature branch: git checkout -b feature/my-feature
3. Make your changes
4. Run the build: npm run build
5. Test locally: SCALA_API_KEY=test npx .
6. Commit: git commit -m "feat: add my feature"
7. Push: git push origin feature/my-feature
8. Open a Pull Request

Development

git clone https://github.com/Alessandro114/scala-mcp-server.git
cd scala-mcp-server
npm install
npm run dev    # Run with tsx (hot reload)
npm run build  # Compile TypeScript

Ecosystem

• enrich-companies (npm) -- CLI to enrich CSV files with company data
• enrich-companies (PyPI) -- Same tool, Python version
• Score Company Lookup -- Chrome extension
• scala-score (PyPI) -- Python SDK
• world-company-database -- Bulk dataset (Kaggle + HuggingFace)
• Score API Docs -- REST API documentation
• n8n Integration -- n8n workflow nodes

License

MIT -- Copyright (c) 2026 Alessandro Binda / S.C.A.L.A. AI OS