README.md

July 24, 2026 · View on GitHub

SCALA

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

Run your entire business from Claude. 33 tools. 19 industries. 250M+ companies.

MCP npm version npm downloads License Smithery Glama 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"

19 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

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

Claude Desktop

Add to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "scala": {
      "command": "npx",
      "args": ["-y", "scala-mcp-server"],
      "env": {
        "SCALA_API_KEY": "your-api-key"
      }
    }
  }
}
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "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

ToolDescriptionCredits
search_companiesSearch 250M+ companies by name, VAT, keyword1
lookup_companyFull company profile by ID or VAT1
company_reportHealth report (basic/pro/enterprise)5-20
database_statsDatabase statistics0
list_countriesCountries with company counts0
check_creditsAPI credits and plan info0

CRM

ToolDescription
crm_list_contactsList/search contacts with pipeline stage filter
crm_create_contactCreate contact with name, email, company, tags
crm_update_contactUpdate any contact field
crm_pipelinePipeline view grouped by stage
crm_contact_timelineFull activity timeline for a contact

Bookings

ToolDescription
booking_get_slotsAvailable time slots for a business
booking_createCreate booking with auto-confirmation email
booking_cancelCancel a booking

Invoicing

ToolDescription
invoice_listList invoices with status filter
invoice_createCreate invoice (multi-provider)
invoice_sendEmail invoice to customer
invoice_get_pdfGet invoice PDF

SARA AI

ToolDescription
sara_chatChat with SARA about your business
sara_conversationsList conversation history
sara_insightsAI-generated business insights
sara_alertsActive business alerts
sara_proactiveProactive AI suggestions

Finance

ToolDescription
finance_summaryRevenue, expenses, profit overview
finance_health_scoreBusiness health score (0-100)
finance_cash_flowCash flow by period

Industry Verticals (19)

ToolDescription
vertical_kpisKPIs for any vertical (DineOS, PropertyOS, etc.)
vertical_list_dataList records from any vertical table
vertical_create_recordCreate records in any vertical
vertical_accessCheck active modules

Workflows

ToolDescription
workflow_listList automation workflows
workflow_runExecute a workflow
workflow_statsWorkflow statistics

Resources

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

ResourceURIDescription
Pricingscala://pricingCurrent plans, enterprise tiers, add-ons
Verticalsscala://verticalsAll 19 industry modules with features
Capabilitiesscala://capabilitiesFull platform feature list

Prompts

Pre-built prompt templates for common workflows:

PromptDescription
enterprise_pitchGenerate a tailored enterprise pitch
business_analysisComprehensive business intelligence report
onboarding_guidePersonalized onboarding checklist

Supported Verticals

ModuleIndustry
DineOSRestaurants & F&B
PropertyOSReal Estate
AgencyOSMarketing Agencies
MotorOSCar Dealerships
TravelOSTravel Agencies
StudioOSArchitecture & Engineering
BeautyOSBeauty & Wellness
CleanOSCleaning & Facility Management
ShopOSRetail
WellnessOSFitness & Wellness
DermalyOSDermatology & Medical
ServiceOSField Services
ProjectOSProject Management
NetworkOSMLM & Referral
PraxisOSMedical Practices
TrichoOSHair & Trichology
ReputationOSReputation Management
AdOSAdvertising
LandIQReal 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 - 19 Verticals - 250M+ Companies

Ecosystem

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