Scala Score

io.github.Alessandro114Published by GitHub account Alessandro114v0.1.3Updated Oct 24, 2026

MCP server for S.C.A.L.A. Score API — let Claude, ChatGPT, and AI agents search 250M+ companies

Overview

AI-generated overview

A local MCP server that connects an AI assistant to the S.C.A.L.A. business platform for CRM, invoicing, bookings, finance, workflows and company search.

What you can do
Search and look up companies in a 250M+ company database, generate company health reports, list countries and check API credits and plan info, with credit costs per call (reports cost 5-20 credits). Manage CRM contacts and pipeline: list, create and update contacts, view pipeline by stage and contact timelines. Handle bookings and invoicing: check available slots, create or cancel bookings, list, create, send invoices and fetch invoice PDFs. Query finance summaries, health scores and cash flow, and read SARA AI chat, insights, alerts and suggestions. Run and inspect automation workflows, and read or create records in industry-specific vertical modules. Read static resources on pricing, verti
When to use it
Useful for small businesses or teams already on the S.C.A.L.A. platform who want to run CRM, invoicing, bookings, finance and company research from an AI conversation instead of separate dashboards.
Requirements
Runs locally via npx (Node.js). Needs a S.C.A.L.A. API key in the SCALA_API_KEY environment variable; the manifest lists it as optional with a free tier, while the README says to get a free 14-day trial key. Network access to the S.C.A.L.A. API is required.
Before you install
The server can create and update CRM contacts, create and cancel bookings, create and email invoices to customers, and run workflows, so actions change real business data and send messages. Company lookups and reports consume API credits, and reports cost 5-20 credits per call. The API key is a secret passed in SCALA_API_KEY; business data is sent to the S.C.A.L.A. service.

Installation

In SourceWeft

  1. Open Scala Score 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

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.3LatestSep 16, 2026

Score

50% 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

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • 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 listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts