Skip to main content
Glama
scala-mcp-server

scala-mcp-server


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 look up company records worldwide — 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.


Related MCP server: sk-registers-mcp

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 (249M company records)

"Find the French company with SIREN 552032534" "Look up a French company by its SIREN/VAT id" "Compare two Norwegian companies by name" "Find the company with tax id IT00159560366"

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:

{
  "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 (31)

Company Intelligence

Tool

Description

Credits

search_companies

Search by name prefix or tax/VAT id (+ country filter)

1

lookup_company

Full company profile by id from search

1

list_countries

Countries available in the Score database

0 (not verified)

check_credits

Remaining credits for the Score key

0

Data coverage and licences. Identification data (name, tax id, address, status, sector) is returned for all countries. Financials (revenue, employees, net income) are returned only for FR, NO, LT, EE, LV, CO, where the data licence is confirmed (~766k filed accounts, measured 14/10/2026). For every other country the record has financials_withheld: "licence_not_confirmed" — no revenue is provided. Where financials exist, revenue_type is reported (filed accounts) or estimated (model estimate). Keep the data_licences field of the output when you display or redistribute data (attribution required, e.g. CO is CC BY-SA 4.0).

Score credentials. Company tools call https://score.get-scala.com/api/v1 (override with SCORE_API_URL) with the X-API-Key header, using SCORE_API_KEY (falls back to SCALA_API_KEY). Free key (50 calls/month, no card): https://score.get-scala.com/builders

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
                                        |
                              31 tools + 3 resources + 3 prompts
                                        |
                    CRM - Invoicing - Bookings - SARA AI - Finance
                    Workflows - 20 Verticals - 249M Company Records

Ecosystem

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 the Score company database

/scala:prospect-research

Pre-meeting company deep dive + talking points

/scala:invoice-chase

Overdue invoices grouped 30/60/90+ days + send reminders

Remote server (Claude connector)

Besides the stdio server above (npx scala-mcp-server, one user per process, key from SCALA_API_KEY, all 31 tools), this repository also ships a remote, read-only MCP server: Streamable HTTP, OAuth 2.0 + PKCE handled by the S.C.A.L.A. backend, 14 read-only tools, no resources or prompts. It is the same code started with MCP_REMOTE=1 (npm run start:remote, image built from Dockerfile.remote). In remote mode no credential is ever read from the environment: every request carries its own token.

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

Data coverage

S.C.A.L.A. Score holds about 249 million company records from public registries and open data in 264 countries (home page of score.get-scala.com: "Data from official registries in 264 countries · 249,353,619 companies", checked 03/11/2026). Not all records have financial data, and coverage varies by country: revenue, employees and score are shown only where the source publishes them. Always check each field before relying on it.

Available Tools

6 tools
check_creditsA

Check your remaining API credits, current plan, and reset date.

Inputs: no named parameters.

company_reportA

Generate a detailed company health report. Available types: basic (overview, 5 credits), pro (financial analysis, 10 credits), enterprise (full due diligence, 20 credits).

Inputs: company_id (required), type.

database_statsA

Get S.C.A.L.A. Score database statistics: total companies, countries covered, last update date.

Inputs: no named parameters.

list_countriesA

List all countries available in the database with company counts per country.

Inputs: no named parameters.

lookup_companyA

Get detailed company information by ID or VAT number. Returns full company profile: legal name, address, revenue, employees, health score, NACE classification, legal form, incorporation date, website, phone, email.

Inputs: company_id (required).

search_companiesA

Search 244M+ companies worldwide by name, VAT number, or keyword. Filter by country (ISO 2-letter code), NACE industry code, and active/inactive status. Returns company name, address, revenue, employees, health score, and more.

Inputs: query (required), country, nace, status, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: credits check, report generation, database stats, country listing, company lookup, and company search. There is no overlap or ambiguity.

    Naming Consistency3/5

    Most tools follow a verb_noun pattern (list_countries, lookup_company, search_companies, check_credits), but company_report and database_stats are noun_noun, creating inconsistency.

    Tool Count5/5

    With 6 tools, the set is well-scoped for a company database service. Each tool covers an essential operation without being overly numerous or sparse.

    Completeness5/5

    The tool set covers all core interactions: search, detailed lookup, country filtering, database statistics, report generation, and account management. No obvious gaps for a read-oriented data provider.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      MCP server for Nordic company registries. Verify companies, check board members, signing authority, and financial data across Norway, Denmark, Finland, and Sweden using official public APIs. 23 tools covering search, details, roles, and batch lookups.
      19
      14
      Apache 2.0
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for Slovak business registers (RPO) — AI agents can query 1.4M+ Slovak legal entities via Slovakia's official Statistical Office API. Search companies by name, IČO, or get full entity details including legal form, address, and statutory representatives.
      2
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for EU company and business data. 9 tools: company search (GLEIF, 2M+ entities), LEI lookup, corporate structures (parent/subsidiaries), trade register search, EU VAT validation (VIES), GDP, unemployment, inflation, and business demography (Eurostat). All APIs free, no keys required.
      9
      6
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      MCP server for Pubrio — the glocalized business data layer for AI agents. 50 tools to search companies, people, jobs, news & ads, enrich records, reveal contacts, manage signal monitors, and access reference data from around the globe.
      51
      46 npm
      MIT