npm scala-mcp-serverstdioMITupdated 13d ago
Run your entire business from Claude. 33 tools. 20 industries. 250M+ companies.
¿Qué puedes hacer con scala score?
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 search 250M+ companies — all without leaving your AI conversation.
Quick Start
npx -y scala-mcp-server
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 — 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)
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-server
Any MCP Client
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) — 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 |
|---|---|
/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
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 — Copyright (c) 2026 Alessandro Binda / S.C.A.L.A. AI OS
Instalación
Añade scala score a tu cliente. Elige el que uses.
claude mcp add scala-mcp-server -- npx -y scala-mcp-servercodex mcp add scala-mcp-server -- npx -y scala-mcp-serveramp mcp add scala-mcp-server -- npx -y scala-mcp-server{
"mcpServers": {
"scala-mcp-server": {
"command": "npx",
"args": [
"-y",
"scala-mcp-server"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"scala-mcp-server": {
"command": "npx",
"args": [
"-y",
"scala-mcp-server"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"scala-mcp-server","command":"npx","args":["-y","scala-mcp-server"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"scala-mcp-server": {
"command": "npx",
"args": [
"-y",
"scala-mcp-server"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"scala-mcp-server": {
"command": "npx",
"args": [
"-y",
"scala-mcp-server"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"scala-mcp-server": {
"command": "npx",
"args": [
"-y",
"scala-mcp-server"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"scala-mcp-server": {
"type": "local",
"command": "npx",
"args": [
"-y",
"scala-mcp-server"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"scala-mcp-server": {
"command": {
"path": "npx",
"args": [
"-y",
"scala-mcp-server"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y scala-mcp-serverRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
Puntuación
72 / 100
Buena
- Documentación25/25
- Mantenimiento19/25
- Confianza13/20
- Capacidad3/15
- Instalación12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 6 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Historial de versiones
| Versiones | Publicada |
|---|---|
| 0.1.3Última | 16 jun 2026 |