# Alessandro114/scala-mcp-server [Health: Active]

**Category:** 📊 Data Platforms  
**Repository:** https://github.com/Alessandro114/scala-mcp-server  
**GitHub Stars:** 2  
**npm Downloads (last month):** 450  
**Views:** 2  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/alessandro114-scala-mcp-server

## Description
Search and enrich data from 250M+ companies across 50+ countries. Company lookup by name, VAT, or ID, NACE sector search, and financial data from official EU business registries. Free tier: 50 lookups/month. Install: npx scala-mcp-server.

## Tools
Capabilities this server exposes over MCP:

- **search_companies** — Search 250M+ companies worldwide by name, VAT number, or keyword. Filter by country (ISO 2-letter), NACE industry code, and status.
- **lookup_company** — Get detailed company profile by ID or VAT number. Returns revenue, employees, health score, NACE classification, legal form, incorporation date, contacts.
- **company_report** — Generate a company health report. Types: basic (5 credits), pro (10), enterprise (20).
- **database_stats** — Get S.C.A.L.A. Score database statistics: total companies, countries, last update.
- **list_countries** — List all countries available in the database with company counts.
- **check_credits** — Check your remaining API credits, plan, and reset date.
- **crm_list_contacts** — List CRM contacts with optional search. Returns name, email, phone, company, deal stage (lead/qualified/proposal/won/lost), score, and tags.
- **crm_create_contact** — Create a new CRM contact with name, email, phone, company, and tags.
- **crm_update_contact** — Update an existing CRM contact by ID. Any field can be updated.
- **crm_pipeline** — Get the CRM pipeline view — contacts grouped by stage with counts and deal values.
- **crm_contact_timeline** — Get the full activity timeline for a contact: calls, emails, meetings, notes, deals.
- **booking_get_slots** — Get available booking slots for a business. Returns time slots that can be booked by customers.
- **booking_create** — Create a new booking/appointment. Sends confirmation email to the customer in their language (IT/EN/DE/FR/ES).
- **booking_cancel** — Cancel an existing booking by its ID.
- **invoice_list** — List invoices with optional filters. Returns invoice number, customer, amount, currency, status (draft/open/paid/overdue/void), and dates.
- **invoice_create** — Create a new invoice. Supports multiple providers: FattureInCloud (IT), Stripe, Xero, QuickBooks, Holded, or local fallback.
- **invoice_send** — Send an invoice to the customer by email.
- **invoice_get_pdf** — Get the PDF download URL for an invoice.
- **sara_chat** — Send a message to SARA, the AI business assistant. SARA can answer questions about your business, customers, bookings, inventory, and more. She has context about your entire SCALA workspace.
- **sara_conversations** — List recent SARA conversations with message counts and last activity.
- **sara_insights** — Get SARA's business insights — AI-generated analysis of trends, anomalies, and actionable recommendations based on your business data.
- **sara_alerts** — Get active SARA alerts — important notifications about your business (low inventory, overdue invoices, missed bookings, etc.).
- **sara_proactive** — Get SARA's proactive suggestions — things SARA thinks you should act on based on patterns she detected in your data.
- **finance_summary** — Get a financial overview: revenue, expenses, profit, outstanding invoices, cash position, and month-over-month trends.
- **finance_health_score** — Get your business financial health score (0-100) with breakdown: liquidity, profitability, receivables aging, and burn rate.
- **finance_cash_flow** — Get cash flow data with inflows, outflows, and net cash by period. Useful for forecasting and trend analysis.
- **vertical_kpis** — Get KPIs for a specific vertical module. Each vertical has domain-specific metrics: DineOS (covers, avg ticket, food cost), PropertyOS (listings, commissions), MotorOS (inventory, test drives, trade-ins), StudioOS (projects, billable hours), etc.
- **vertical_list_data** — List records from any vertical table. Examples: dineos menu items, motoros vehicles, propertyos listings, beautyos appointments, travelos itineraries.
- **vertical_create_record** — Create a record in any vertical table. Pass the table name and the fields as data.
- **vertical_access** — Check which vertical modules are active for the current account.
- **workflow_list** — List all automation workflows with their status (active/paused), trigger type, last run, and success rate.
- **workflow_run** — Manually execute a workflow by ID. Returns the run result and logs.
- **workflow_stats** — Get workflow statistics: total runs, success rate, avg duration, errors.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "scala-mcp-server": {
    "command": "npx",
    "args": ["-y","scala-mcp-server"],
    "env": {
      "SCALA_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `SCALA_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation & README

<p align="center">
  <img src="https://get-scala.com/scala-logo.svg" width="80" alt="SCALA">
</p>

<h1 align="center">S.C.A.L.A. MCP Server</h1>

<p align="center">
  <strong>Run your entire business from Claude. 33 tools. 20 industries. 250M+ companies.</strong>
</p>

<p align="center">
  <a href="https://github.com/Alessandro114/scala-mcp-server/actions/workflows/ci.yml"><img src="https://github.com/Alessandro114/scala-mcp-server/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
  <a href="https://github.com/Alessandro114/scala-mcp-server/actions/workflows/ci.yml"><img src="https://img.shields.io/badge/coverage-100%25-brightgreen" alt="Coverage"></a>
  <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-compatible-purple" alt="MCP"></a>
  <a href="https://www.npmjs.com/package/scala-mcp-server"><img src="https://img.shields.io/npm/v/scala-mcp-server" alt="npm version"></a>
  <a href="https://www.npmjs.com/package/scala-mcp-server"><img src="https://img.shields.io/npm/dm/scala-mcp-server" alt="npm downloads"></a>
  <a href="https://github.com/Alessandro114/scala-mcp-server/blob/main/LICENSE"><img src="https://img.shields.io/github/license/Alessandro114/scala-mcp-server" alt="License"></a>
  <a href="https://smithery.ai/server/Alessandro114/scala-mcp-server"><img src="https://smithery.ai/badge/Alessandro114/scala-mcp-server" alt="Smithery"></a>
  <a href="https://glama.ai/mcp/servers/Alessandro114/scala-mcp-server"><img src="https://glama.ai/mcp/servers/Alessandro114/scala-mcp-server/badges/score.svg" alt="Glama Score"></a>
</p>

---

An [MCP server](https://modelcontextprotocol.io) that turns Claude into a full business operating system. Manage your CRM, send invoices, book appointments, chat with your AI assistant, run workflows, and search 250M+ companies — all without leaving your AI conversation.

## Quick Start

```bash
npx -y scala-mcp-server
```

One command. Set your API key and go:

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

> Get a free API key at [app.get-scala.com](https://app.get-scala.com) — 14-day trial, no credit card.

---

## 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 (250M+ companies)
> "Find the top 10 SaaS companies in Germany"
> "Look up Ferrero's financial health"
> "Compare construction companies in Milan vs Munich"
> "Generate a due diligence report on company XYZ"

### Workflow Automation
> "List all active workflows"
> "Run the weekly report workflow"
> "Show workflow success rates"

---

## Setup

### Smithery (Recommended)

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

### Claude Desktop

Add to your `claude_desktop_config.json`:

<details>
<summary><strong>macOS</strong>: <code>~/Library/Application Support/Claude/claude_desktop_config.json</code></summary>

```json
{
  "mcpServers": {
    "scala": {
      "command": "npx",
      "args": ["-y", "scala-mcp-server"],
      "env": {
        "SCALA_API_KEY": "your-api-key"
      }
    }
  }
}
```
</details>

<details>
<summary><strong>Windows</strong>: <code>%APPDATA%\Claude\claude_desktop_config.json</code></summary>

```json
{
  "mcpServers": {
    "scala": {
      "command": "npx",
      "args": ["-y", "scala-mcp-server"],
      "env": {
        "SCALA_API_KEY": "your-api-key"
      }
    }
  }
}
```
</details>

### Claude Code

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

### Any MCP Client

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

---

## Tools (33)

### Company Intelligence
| Tool | Description | Credits |
|------|-------------|---------|
| `search_companies` | Search 250M+ companies by name, VAT, keyword | 1 |
| `lookup_company` | Full company profile by ID or VAT | 1 |
| `company_report` | Health report (basic/pro/enterprise) | 5-20 |
| `database_stats` | Database statistics | 0 |
| `list_countries` | Countries with company counts | 0 |
| `check_credits` | API credits and plan info | 0 |

### CRM
| Tool | Description |
|------|-------------|
| `crm_list_contacts` | List/search contacts with pipeline stage filter |
| `crm_create_contact` | Create contact with name, email, company, tags |
| `crm_update_contact` | Update any contact field |
| `crm_pipeline` | Pipeline view grouped by stage |
| `crm_contact_timeline` | Full activity timeline for a contact |

### Bookings
| Tool | Description |
|------|-------------|
| `booking_get_slots` | Available time slots for a business |
| `booking_create` | Create booking with auto-confirmation email |
| `booking_cancel` | Cancel a booking |

### Invoicing
| Tool | Description |
|------|-------------|
| `invoice_list` | List invoices with status filter |
| `invoice_create` | Create invoice (multi-provider) |
| `invoice_send` | Email invoice to customer |
| `invoice_get_pdf` | Get invoice PDF |

### SARA AI
| Tool | Description |
|------|-------------|
| `sara_chat` | Chat with SARA about your business |
| `sara_conversations` | List conversation history |
| `sara_insights` | AI-generated business insights |
| `sara_alerts` | Active business alerts |
| `sara_proactive` | Proactive AI suggestions |

### Finance
| Tool | Description |
|------|-------------|
| `finance_summary` | Revenue, expenses, profit overview |
| `finance_health_score` | Business health score (0-100) |
| `finance_cash_flow` | Cash flow by period |

### Industry Verticals (19)
| Tool | Description |
|------|-------------|
| `vertical_kpis` | KPIs for any vertical (DineOS, PropertyOS, etc.) |
| `vertical_list_data` | List records from any vertical table |
| `vertical_create_record` | Create records in any vertical |
| `vertical_access` | Check active modules |

### Workflows
| Tool | Description |
|------|-------------|
| `workflow_list` | List automation workflows |
| `workflow_run` | Execute a workflow |
| `workflow_stats` | Workflow statistics |

---

## Resources

The server exposes static resources that Claude can read for context:

| Resource | URI | Description |
|----------|-----|-------------|
| Pricing | `scala://pricing` | Current plans, enterprise tiers, add-ons |
| Verticals | `scala://verticals` | All 20 industry modules with features |
| Capabilities | `scala://capabilities` | Full platform feature list |

---

## Prompts

Pre-built prompt templates for common workflows:

| Prompt | Description |
|--------|-------------|
| `enterprise_pitch` | Generate a tailored enterprise pitch |
| `business_analysis` | Comprehensive business intelligence report |
| `onboarding_guide` | 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
                                        |
                              33 tools + 3 resources + 3 prompts
                                        |
                    CRM - Invoicing - Bookings - SARA AI - Finance
                    Workflows - 20 Verticals - 250M+ Companies
```

## Ecosystem

- **[enrich-companies (npm)](https://www.npmjs.com/package/enrich-companies)** — CLI to enrich CSV files with company data
- **[enrich-companies (PyPI)](https://pypi.org/project/enrich-companies/)** — Same tool, Python version
- **[scala-score (PyPI)](https://pypi.org/project/scala-score/)** — Python SDK
- **[world-company-database](https://github.com/Alessandro114/world-company-database)** — Curated list of 40+ free company databases
- **[Score API Docs](https://alessandro114.github.io/score-api-docs/)** — REST API documentation
- **[n8n Integration](https://github.com/Alessandro114/n8n-nodes-scala)** — n8n workflow nodes

## Claude Plugin Skills

The server includes 5 pre-built skills for Claude Code (in `skills/`):

| Skill | What it does |
|-------|-------------|
| `/scala:daily-briefing` | Morning briefing — alerts, invoices, pipeline, KPIs, AI suggestions |
| `/scala:business-health` | Health score + cash flow + recommendations |
| `/scala:competitor-intel` | Competitor research from 250M+ companies |
| `/scala:prospect-research` | Pre-meeting company deep dive + talking points |
| `/scala:invoice-chase` | Overdue invoices grouped 30/60/90+ days + send reminders |

## Development

```bash
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
```

## License

[MIT](https://github.com/Alessandro114/scala-mcp-server/blob/HEAD/LICENSE) — Copyright (c) 2026 Alessandro Binda / S.C.A.L.A. AI OS