io.github.Alessandro114/scala-ai-os

S.C.A.L.A. AI OS and Score: company data, CRM and SARA tools for AI agents via MCP.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package scala-mcp-server

Claude Code

claude mcp add scala-ai-os -e 'SCALA_API_KEY=<your scala_api_key>' -e 'SCORE_API_KEY=<your score_api_key>' -e 'SCORE_API_URL=<SCORE_API_URL>' -e 'SCALA_API_URL=<SCALA_API_URL>' -- npx -y scala-mcp-server@1.1.0

JSON configuration (Claude Desktop, Cursor, VS Code)

{
    "mcpServers": {
        "scala-ai-os": {
            "command": "npx",
            "args": [
                "-y",
                "scala-mcp-server@1.1.0"
            ],
            "env": {
                "SCALA_API_KEY": "<your scala_api_key>",
                "SCORE_API_KEY": "<your score_api_key>",
                "SCORE_API_URL": "<SCORE_API_URL>",
                "SCALA_API_URL": "<SCALA_API_URL>"
            }
        }
    }
}

Environment variables

SCALA_API_KEY required secret Your SCALA API key. Get one free at https://app.get-scala.com
SCORE_API_KEY secret Score API key for company data (free: https://score.get-scala.com/builders). Falls back to SCALA_API_KEY.
SCORE_API_URL Score API base URL (optional, defaults to https://score.get-scala.com/api/v1)
SCALA_API_URL API base URL (optional, defaults to https://app.get-scala.com)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents

S.C.A.L.A. MCP Server
Quick Start
What You Can Do
Setup
Tools (33)
Resources
Prompts
Supported Verticals
Architecture
Ecosystem
Claude Plugin Skills
Development
License

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

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

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:

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

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

Frequently asked questions

What is io.github.Alessandro114/scala-ai-os?

S.C.A.L.A. AI OS and Score: company data, CRM and SARA tools for AI agents via MCP.

How do I install io.github.Alessandro114/scala-ai-os?

It runs on your machine. In Claude Code: claude mcp add scala-ai-os -e 'SCALA_API_KEY=<your scala_api_key>' -e 'SCORE_API_KEY=<your score_api_key>' -e 'SCORE_API_URL=<SCORE_API_URL>' -e 'SCALA_API_URL=<SCALA_API_URL>' -- npx -y scala-mcp-server@1.1.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.Alessandro114/scala-ai-os need an API key?

Yes. It expects SCALA_API_KEY, SCORE_API_KEY, which you set in its configuration.

Is io.github.Alessandro114/scala-ai-os open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.Alessandro114/scala-ai-os?

It is published by Alessandro114. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.

Server details

Listed in: Official MCP Registry
Publisher: Alessandro114
Category: Marketing and sales
Runs: Local
GitHub stars: ★ 2
License: MIT
Language: TypeScript
Last commit: Oct 26, 2026
Open issues: 0
Version: 1.1.0
Published: Oct 26, 2026

io.github.Alessandro114/scala-ai-os

Similar servers

Mailchimp Mailchimp MCP Pack — manage audiences, campaigns, and members via Mailchimp Marketing API.
Leadconnector LeadConnector / GoHighLevel MCP Pack — wraps the GoHighLevel CRM for AI agents.
L2beat L2BEAT MCP — Layer 2 ecosystem analytics
App Console: Google Play, App Store Connect, AdMob Google Play Console, App Store Connect and AdMob via official APIs: releases, reviews, ...
Flashalpha FlashAlpha MCP — wraps the FlashAlpha options-exposure analytics API (lab.flashalpha.com).
Ema Article57 EMA Article 57 product data — every medicine with a valid marketing authorisation anywh...
Pylot AI Draft, schedule and publish on-brand social posts and images for a small business from ...
Posthive Schedule and manage social media posts on Bluesky, Threads, Instagram, LinkedIn, Mastod...

Marketing and sales