Scala Ai Os

io.github.Alessandro114Published by GitHub account Alessandro114v1.1.0Updated Oct 29, 2026

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

VerifiedSTDIODesktop onlyBusiness & CommerceAI & ML

Overview

Scala Ai Os's local MCP server; no sign-in required; STDIO; 31 tools.

No AI overview yet: these facts come from the registry entry and the server itself.

Installation

In SourceWeft

  1. Open Scala Ai Os in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

[SCALA]

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

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

[CI] [Coverage] [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

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 — 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:

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

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

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 20 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 - 20 Verticals - 250M+ Companies

Ecosystem

Claude Plugin Skills

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

SkillWhat it does
/scala:daily-briefingMorning briefing — alerts, invoices, pipeline, KPIs, AI suggestions
/scala:business-healthHealth score + cash flow + recommendations
/scala:competitor-intelCompetitor research from 250M+ companies
/scala:prospect-researchPre-meeting company deep dive + talking points
/scala:invoice-chaseOverdue invoices grouped 30/60/90+ days + send reminders

Development

bash
git clone https://github.com/Alessandro114/scala-mcp-server.gitcd scala-mcp-servernpm installnpm 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

Source: README.md at commit a388aa3

Tools

31

search_companies

Search companies by name prefix or tax/VAT id. Coverage and licence status differ per country: see data_licences in the output (some countries are marked to_verify). Optional ISO 2-letter country filter. 1 credit per call. Financial fields (revenue, employees, net income) are returned only for FR, NO, LT, EE, LV, CO, where the data licence is confirmed; for all other countries the record carries financials_withheld='licence_not_confirmed'. Where present, revenue_type is 'reported' (filed accounts) or 'estimated' (model estimate). Keep the data_licences field of the output when displaying or redistributing data (attribution required).

Parameterslimitquerytax_idcountry

lookup_company

Full company profile by the id returned from search_companies. 1 credit. Includes revenue_type, revenue_confidence and source where financials are available. Financial fields (revenue, employees, net income) are returned only for FR, NO, LT, EE, LV, CO, where the data licence is confirmed; for all other countries the record carries financials_withheld='licence_not_confirmed'. Where present, revenue_type is 'reported' (filed accounts) or 'estimated' (model estimate). Keep the data_licences field of the output when displaying or redistributing data (attribution required).

Parameterscompany_idrequired

list_countries

List the countries available in the Score database (company counts; financial-field counts only for FR, NO, LT, EE, LV, CO).

Takes no parameters.

check_credits

Remaining API credits for the current Score key (free call).

Takes no parameters.

crm_list_contacts

List CRM contacts with optional search. Returns name, email, phone, company, deal stage (lead/qualified/proposal/won/lost), score, and tags.

Parameterslimitstagesearch

crm_create_contact

Create a new CRM contact with name, email, phone, company, and tags.

Parameterstagsemailnotesphonestagecompanyfull_namerequired

crm_update_contact

Update an existing CRM contact by ID. Any field can be updated.

Parametersidrequiredtagsemailnotesphonestagecompanyfull_name

crm_pipeline

Get the CRM pipeline view — contacts grouped by stage with counts and deal values.

Takes no parameters.

crm_contact_timeline

Get the full activity timeline for a contact: calls, emails, meetings, notes, deals.

Parameterscontact_idrequired

booking_get_slots

Get available booking slots for a business. Returns time slots that can be booked by customers.

Parametersdatebooking_coderequired

booking_create

Create a new booking/appointment. Sends confirmation email to the customer in their language (IT/EN/DE/FR/ES).

Parametersdaterequiredtimerequirednotesservicebooking_coderequiredcustomer_namerequiredcustomer_emailrequiredcustomer_phone

booking_cancel

Cancel an existing booking by its ID.

Parametersbooking_idrequired

invoice_list

List invoices with optional filters. Returns invoice number, customer, amount, currency, status (draft/open/paid/overdue/void), and dates.

Parameterslimitstatus

invoice_create

Create a new invoice. Supports multiple providers: FattureInCloud (IT), Stripe, Xero, QuickBooks, Holded, or local fallback.

Parametersitemsrequirednotescurrencydue_dayscustomer_namecustomer_emailrequired

invoice_send

Send an invoice to the customer by email.

Parametersinvoice_idrequired

invoice_get_pdf

Get the PDF download URL for an invoice.

Parametersinvoice_idrequired

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.

Parametersmessagerequiredconversation_id

sara_conversations

List recent SARA conversations with message counts and last activity.

Parameterslimit

sara_insights

Get SARA's business insights — AI-generated analysis of trends, anomalies, and actionable recommendations based on your business data.

Takes no parameters.

sara_alerts

Get active SARA alerts — important notifications about your business (low inventory, overdue invoices, missed bookings, etc.).

Takes no parameters.

sara_proactive

Get SARA's proactive suggestions — things SARA thinks you should act on based on patterns she detected in your data.

Takes no parameters.

finance_summary

Get a financial overview: revenue, expenses, profit, outstanding invoices, cash position, and month-over-month trends.

Takes no parameters.

finance_health_score

Get your business financial health score (0-100) with breakdown: liquidity, profitability, receivables aging, and burn rate.

Takes no parameters.

finance_cash_flow

Get cash flow data with inflows, outflows, and net cash by period. Useful for forecasting and trend analysis.

Parametersmonthsperiod

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.

Parametersverticalrequired

vertical_list_data

List records from any vertical table. Examples: dineos menu items, motoros vehicles, propertyos listings, beautyos appointments, travelos itineraries.

Parameterslimittablerequiredsearch

vertical_create_record

Create a record in any vertical table. Pass the table name and the fields as data.

Parametersdatarequiredtablerequired

vertical_access

Check which vertical modules are active for the current account.

Takes no parameters.

workflow_list

List all automation workflows with their status (active/paused), trigger type, last run, and success rate.

Takes no parameters.

workflow_run

Manually execute a workflow by ID. Returns the run result and logs.

Parametersinputworkflow_idrequired

workflow_stats

Get workflow statistics: total runs, success rate, avg duration, errors.

Takes no parameters.

Version history

1
  1. v1.1.0LatestOct 26, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts