scala-mcp-server
This MCP server exposes S.C.A.L.A. Score company-intelligence tools for searching and analyzing 244M+ company records worldwide.
Search companies by name, VAT number, or keyword, with filters for country, NACE industry code, active/inactive status, and result limit.
Look up detailed company profiles by company ID or VAT number, including address, revenue, employees, health score, NACE classification, legal form, incorporation date, and contact details.
Generate company health/due-diligence reports at basic, pro, or enterprise levels.
Retrieve database statistics such as total companies, countries covered, and last update date.
List available countries with company counts.
Check remaining API credits, current plan, and reset date.
Note: the README describes 31 tools including CRM, invoicing, bookings, SARA AI, finance, workflows, and verticals, but the provided schema only exposes the six company-intelligence tools above.
An MCP server that turns Claude into a full business operating system. Manage your CRM, send invoices, book appointments, chat with your AI assistant, run workflows, and look up company records worldwide — all without leaving your AI conversation.
Quick Start
npx -y scala-mcp-serverOne command. Set your API key and go:
SCALA_API_KEY=your-key npx -y scala-mcp-serverGet a free API key at app.get-scala.com — 14-day trial, no credit card.
Related MCP server: sk-registers-mcp
What You Can Do
CRM & Sales Pipeline
"Show my sales pipeline" "Create a contact for Maria Rossi at Ferrero" "Move the Johnson deal to 'proposal' stage" "Show the timeline for contact abc-123"
Bookings & Appointments
"What slots are available tomorrow at 2pm?" "Book a consultation for Marco next Thursday at 10am" "Cancel booking #456"
Invoicing
"List all overdue invoices" "Create an invoice for the Q3 consulting work — EUR 4,500" "Send invoice #789 to the client"
SARA AI Assistant
"Ask SARA what happened with customer complaints this week" "Show me SARA's business insights" "What alerts does SARA have for me?"
Financial Analytics
"What's my business health score?" "Show cash flow for the last 6 months" "Give me a financial summary"
20 Industry Verticals
"Show restaurant KPIs — covers, avg ticket, food cost" "List all vehicles in the dealership inventory" "What are this month's real estate commissions?" "Show studio project milestones"
Company Intelligence (249M company records)
"Find the French company with SIREN 552032534" "Look up a French company by its SIREN/VAT id" "Compare two Norwegian companies by name" "Find the company with tax id IT00159560366"
Workflow Automation
"List all active workflows" "Run the weekly report workflow" "Show workflow success rates"
Setup
Smithery (Recommended)
npx @smithery/cli mcp add Alessandro114/scala-mcp-server --config '{"scalaApiKey":"your-key"}'Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"scala": {
"command": "npx",
"args": ["-y", "scala-mcp-server"],
"env": {
"SCALA_API_KEY": "your-api-key"
}
}
}
}{
"mcpServers": {
"scala": {
"command": "npx",
"args": ["-y", "scala-mcp-server"],
"env": {
"SCALA_API_KEY": "your-api-key"
}
}
}
}Claude Code
claude mcp add scala -e SCALA_API_KEY=your-key -- npx -y scala-mcp-serverAny MCP Client
SCALA_API_KEY=your-key npx -y scala-mcp-serverTools (31)
Company Intelligence
Tool | Description | Credits |
| Search by name prefix or tax/VAT id (+ country filter) | 1 |
| Full company profile by id from search | 1 |
| Countries available in the Score database | 0 (not verified) |
| Remaining credits for the Score key | 0 |
Data coverage and licences. Identification data (name, tax id, address, status, sector) is returned for all countries. Financials (revenue, employees, net income) are returned only for FR, NO, LT, EE, LV, CO, where the data licence is confirmed (~766k filed accounts, measured 14/10/2026). For every other country the record has
financials_withheld: "licence_not_confirmed"— no revenue is provided. Where financials exist,revenue_typeisreported(filed accounts) orestimated(model estimate). Keep thedata_licencesfield of the output when you display or redistribute data (attribution required, e.g. CO is CC BY-SA 4.0).Score credentials. Company tools call
https://score.get-scala.com/api/v1(override withSCORE_API_URL) with theX-API-Keyheader, usingSCORE_API_KEY(falls back toSCALA_API_KEY). Free key (50 calls/month, no card): https://score.get-scala.com/builders
CRM
Tool | Description |
| List/search contacts with pipeline stage filter |
| Create contact with name, email, company, tags |
| Update any contact field |
| Pipeline view grouped by stage |
| Full activity timeline for a contact |
Bookings
Tool | Description |
| Available time slots for a business |
| Create booking with auto-confirmation email |
| Cancel a booking |
Invoicing
Tool | Description |
| List invoices with status filter |
| Create invoice (multi-provider) |
| Email invoice to customer |
| Get invoice PDF |
SARA AI
Tool | Description |
| Chat with SARA about your business |
| List conversation history |
| AI-generated business insights |
| Active business alerts |
| Proactive AI suggestions |
Finance
Tool | Description |
| Revenue, expenses, profit overview |
| Business health score (0-100) |
| Cash flow by period |
Industry Verticals (19)
Tool | Description |
| KPIs for any vertical (DineOS, PropertyOS, etc.) |
| List records from any vertical table |
| Create records in any vertical |
| Check active modules |
Workflows
Tool | Description |
| List automation workflows |
| Execute a workflow |
| Workflow statistics |
Resources
The server exposes static resources that Claude can read for context:
Resource | URI | Description |
Pricing |
| Current plans, enterprise tiers, add-ons |
Verticals |
| All 20 industry modules with features |
Capabilities |
| Full platform feature list |
Prompts
Pre-built prompt templates for common workflows:
Prompt | Description |
| Generate a tailored enterprise pitch |
| Comprehensive business intelligence report |
| Personalized onboarding checklist |
Supported Verticals
Module | Industry |
DineOS | Restaurants & F&B |
PropertyOS | Real Estate |
AgencyOS | Marketing Agencies |
MotorOS | Car Dealerships |
TravelOS | Travel Agencies |
StudioOS | Architecture & Engineering |
BeautyOS | Beauty & Wellness |
CleanOS | Cleaning & Facility Management |
ShopOS | Retail |
WellnessOS | Fitness & Wellness |
DermalyOS | Dermatology & Medical |
ServiceOS | Field Services |
ProjectOS | Project Management |
NetworkOS | MLM & Referral |
PraxisOS | Medical Practices |
TrichoOS | Hair & Trichology |
ReputationOS | Reputation Management |
AdOS | Advertising |
LandIQ | Real Estate Development |
Architecture
Your AI <--> MCP Protocol <--> scala-mcp-server <--> S.C.A.L.A. API
|
31 tools + 3 resources + 3 prompts
|
CRM - Invoicing - Bookings - SARA AI - Finance
Workflows - 20 Verticals - 249M Company RecordsEcosystem
enrich-companies (npm) — CLI to enrich CSV files with company data
enrich-companies (PyPI) — Same tool, Python version
scala-score (PyPI) — Python SDK
world-company-database — Curated list of 40+ free company databases
Score API Docs — REST API documentation
n8n Integration — n8n workflow nodes
Claude Plugin Skills
The server includes 5 pre-built skills for Claude Code (in skills/):
Skill | What it does |
| Morning briefing — alerts, invoices, pipeline, KPIs, AI suggestions |
| Health score + cash flow + recommendations |
| Competitor research from the Score company database |
| Pre-meeting company deep dive + talking points |
| Overdue invoices grouped 30/60/90+ days + send reminders |
Remote server (Claude connector)
Besides the stdio server above (npx scala-mcp-server, one user per process, key from SCALA_API_KEY, all 31 tools), this repository also ships a remote, read-only MCP server: Streamable HTTP, OAuth 2.0 + PKCE handled by the S.C.A.L.A. backend, 14 read-only tools, no resources or prompts. It is the same code started with MCP_REMOTE=1 (npm run start:remote, image built from Dockerfile.remote). In remote mode no credential is ever read from the environment: every request carries its own token.
Connector page for users: docs/claude-connector.md (address
https://mcp.get-scala.com/mcp)Operations and design: docs/REMOTE.md
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 TypeScriptLicense
MIT — Copyright (c) 2026 Alessandro Binda / S.C.A.L.A. AI OS
Data coverage
S.C.A.L.A. Score holds about 249 million company records from public registries and open data in 264 countries (home page of score.get-scala.com: "Data from official registries in 264 countries · 249,353,619 companies", checked 03/11/2026). Not all records have financial data, and coverage varies by country: revenue, employees and score are shown only where the source publishes them. Always check each field before relying on it.
Available Tools
6 toolscheck_creditsA
Check your remaining API credits, current plan, and reset date.
Inputs: no named parameters.
company_reportA
Generate a detailed company health report. Available types: basic (overview, 5 credits), pro (financial analysis, 10 credits), enterprise (full due diligence, 20 credits).
Inputs: company_id (required), type.
database_statsA
Get S.C.A.L.A. Score database statistics: total companies, countries covered, last update date.
Inputs: no named parameters.
list_countriesA
List all countries available in the database with company counts per country.
Inputs: no named parameters.
lookup_companyA
Get detailed company information by ID or VAT number. Returns full company profile: legal name, address, revenue, employees, health score, NACE classification, legal form, incorporation date, website, phone, email.
Inputs: company_id (required).
search_companiesA
Search 244M+ companies worldwide by name, VAT number, or keyword. Filter by country (ISO 2-letter code), NACE industry code, and active/inactive status. Returns company name, address, revenue, employees, health score, and more.
Inputs: query (required), country, nace, status, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a clearly distinct purpose: credits check, report generation, database stats, country listing, company lookup, and company search. There is no overlap or ambiguity.
Most tools follow a verb_noun pattern (list_countries, lookup_company, search_companies, check_credits), but company_report and database_stats are noun_noun, creating inconsistency.
With 6 tools, the set is well-scoped for a company database service. Each tool covers an essential operation without being overly numerous or sparse.
The tool set covers all core interactions: search, detailed lookup, country filtering, database statistics, report generation, and account management. No obvious gaps for a read-oriented data provider.
Maintenance
Related MCP Connectors
Remote MCP server to enrich company profiles with structured B2B data and confidence scores.
Official Openapi® MCP server: Italian company data, PEC, SMS, vehicles, geocoding and more APIs.
Nordic company intelligence: look up companies, AI summaries, scores and signals via MCP.
OpenCorporates MCP — Global company registry data (BYO key)
Related MCP Servers
- AlicenseAqualityBmaintenanceMCP server for Nordic company registries. Verify companies, check board members, signing authority, and financial data across Norway, Denmark, Finland, and Sweden using official public APIs. 23 tools covering search, details, roles, and batch lookups.1914Apache 2.0
- AlicenseAqualityDmaintenanceMCP server for Slovak business registers (RPO) — AI agents can query 1.4M+ Slovak legal entities via Slovakia's official Statistical Office API. Search companies by name, IČO, or get full entity details including legal form, address, and statutory representatives.21MIT
- AlicenseAqualityDmaintenanceMCP server for EU company and business data. 9 tools: company search (GLEIF, 2M+ entities), LEI lookup, corporate structures (parent/subsidiaries), trade register search, EU VAT validation (VIES), GDP, unemployment, inflation, and business demography (Eurostat). All APIs free, no keys required.96MIT
- AlicenseAqualityBmaintenanceMCP server for Pubrio — the glocalized business data layer for AI agents. 50 tools to search companies, people, jobs, news & ads, enrich records, reveal contacts, manage signal monitors, and access reference data from around the globe.5146 npmMIT