# io.github.Alessandro114/scala-ai-os (npm · scala-mcp-server)

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

- Trust score: 74/100 (medium)
- Change this week: +3
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

## Components

- npm · `scala-mcp-server`: 74/100 (this document), [markdown](https://verifymcp.io/servers/alessandro114-scala-ai-os/scala-mcp-server.md), [page](https://verifymcp.io/servers/alessandro114-scala-ai-os/scala-mcp-server)

## Channel facts

- Registry: `npm`
- Package: `scala-mcp-server`
- Version: `1.1.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Supply Chain Security**: 98/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 30 of 92 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 10 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 81/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Tool/resource definitions use about 1954 tokens (~57/item across 34 items; 31 tools + 3 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 33/100
  - Stability observed for 10 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 96/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 88% of tool parameters carry a description.
- **Tool Safety**: 75/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - 0 of 2 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "invoice_send" implies "send" and declares no destructiveHint at all, which the MCP spec reads as destructive by default.
  - An AI judge read all 32 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the io.github.Alessandro114/scala-ai-os MCP server?

io.github.Alessandro114/scala-ai-os runs locally as an npm package, launched with npx -y scala-mcp-server. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add alessandro114-scala-ai-os -- npx -y scala-mcp-server
```

### Cursor

```json
{
  "mcpServers": {
    "alessandro114-scala-ai-os": {
      "command": "npx",
      "args": [
        "-y",
        "scala-mcp-server"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "alessandro114-scala-ai-os": {
      "command": "npx",
      "args": [
        "-y",
        "scala-mcp-server"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add alessandro114-scala-ai-os -- npx -y scala-mcp-server
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "alessandro114-scala-ai-os": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "scala-mcp-server"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add alessandro114-scala-ai-os --command npx --arg -y --arg scala-mcp-server
```

### Hermes

```yaml
mcp_servers:
  alessandro114-scala-ai-os:
    command: "npx"
    args: ["-y", "scala-mcp-server"]
```

### Netclaw

```json
{
  "McpServers": {
    "alessandro114-scala-ai-os": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "scala-mcp-server"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add alessandro114-scala-ai-os -t stdio -c npx -a -y scala-mcp-server
```

### Other

```json
{
  "mcpServers": {
    "alessandro114-scala-ai-os": {
      "command": "npx",
      "args": [
        "-y",
        "scala-mcp-server"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-05 (score 74, +1)

No change was recorded against any check on this day. Stability & Change Management went from 30 to 33. That category is still filling its 30-day observation window: 9 days of observed history at the previous scan, 10 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-03 (score 73, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-31 (score 72, +1)

No change was recorded against any check on this day. Stability & Change Management went from 13 to 17. That category is still filling its 30-day observation window: 4 days of observed history at the previous scan, 5 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-29 (score 71, +1)

No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-27 (score 70, +1)

No change was recorded against any check on this day. Stability & Change Management went from 0 to 3. That category is still filling its 30-day observation window: 0 days of observed history at the previous scan, 1 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-26 (score 69)

First indexed and scored.

## MCP tools (31)

### `search_companies` (~237 tokens)

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).

Input parameters:

- `country` (string): ISO 2-letter country code (e.g. FR, IT, DE)
- `limit` (number): Max results (1-100, default 10)
- `query` (string): Company name (prefix match). Provide query or tax_id.
- `tax_id` (string): Tax/VAT id, e.g. IT00159560366. Provide query or tax_id.

### `lookup_company` (~148 tokens)

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).

Input parameters:

- `company_id` (string, required): Company id from search_companies

### `list_countries` (~38 tokens)

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

### `check_credits` (~21 tokens)

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

### `crm_list_contacts` (~82 tokens)

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

Input parameters:

- `limit` (number): Max results (default 20)
- `search` (string): Search by name, email, or company
- `stage` (string): Filter by pipeline stage

### `crm_create_contact` (~98 tokens)

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

Input parameters:

- `company` (string): Company name
- `email` (string): Email address
- `full_name` (string, required): Contact full name
- `notes` (string): Notes about the contact
- `phone` (string): Phone number
- `stage` (string): Pipeline stage (default: lead)
- `tags` (array): Tags to assign

### `crm_update_contact` (~82 tokens)

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

Input parameters:

- `company` (string)
- `email` (string)
- `full_name` (string)
- `id` (string, required): Contact ID
- `notes` (string)
- `phone` (string)
- `stage` (string)
- `tags` (array)

### `crm_pipeline` (~24 tokens)

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

### `crm_contact_timeline` (~39 tokens)

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

Input parameters:

- `contact_id` (string, required): Contact ID

### `booking_get_slots` (~52 tokens)

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

Input parameters:

- `booking_code` (string, required): Business booking code
- `date` (string): Date to check (YYYY-MM-DD)

### `booking_create` (~123 tokens)

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

Input parameters:

- `booking_code` (string, required): Business booking code
- `customer_email` (string, required): Customer email
- `customer_name` (string, required): Customer full name
- `customer_phone` (string): Customer phone
- `date` (string, required): Booking date (YYYY-MM-DD)
- `notes` (string): Additional notes
- `service` (string): Service name or ID
- `time` (string, required): Booking time (HH:MM)

### `booking_cancel` (~28 tokens)

Cancel an existing booking by its ID.

Input parameters:

- `booking_id` (string, required): Booking ID to cancel

### `invoice_list` (~63 tokens)

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

Input parameters:

- `limit` (number): Max results (default 20)
- `status` (string): Filter by invoice status

### `invoice_create` (~112 tokens)

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

Input parameters:

- `currency` (string): Currency code (EUR, USD, GBP). Default: EUR
- `customer_email` (string, required): Customer email
- `customer_name` (string): Customer name
- `due_days` (number): Days until due (default 30)
- `items` (array, required): Line items
- `notes` (string): Invoice notes

### `invoice_send` (~29 tokens)

Send an invoice to the customer by email.

Input parameters:

- `invoice_id` (string, required): Invoice ID to send

### `invoice_get_pdf` (~28 tokens)

Get the PDF download URL for an invoice.

Input parameters:

- `invoice_id` (string, required): Invoice ID

### `sara_chat` (~75 tokens)

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.

Input parameters:

- `conversation_id` (string): Conversation ID to continue (optional)
- `message` (string, required): Message to send to SARA

### `sara_conversations` (~34 tokens)

List recent SARA conversations with message counts and last activity.

Input parameters:

- `limit` (number): Max conversations (default 20)

### `sara_insights` (~33 tokens)

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

### `sara_alerts` (~32 tokens)

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

### `sara_proactive` (~33 tokens)

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

### `finance_summary` (~31 tokens)

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

### `finance_health_score` (~36 tokens)

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

### `finance_cash_flow` (~61 tokens)

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

Input parameters:

- `months` (number): Lookback months (default 6)
- `period` (string): Aggregation period (default: monthly)

### `vertical_kpis` (~77 tokens)

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.

Input parameters:

- `vertical` (string, required): Vertical module slug

### `vertical_list_data` (~89 tokens)

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

Input parameters:

- `limit` (number): Max results (default 20)
- `search` (string): Search/filter term
- `table` (string, required): Table name (e.g. dineos_menu, motoros_vehicles, propertyos_listings)

### `vertical_create_record` (~50 tokens)

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

Input parameters:

- `data` (object, required): Record fields (varies by table)
- `table` (string, required): Table name

### `vertical_access` (~19 tokens)

Check which vertical modules are active for the current account.

### `workflow_list` (~30 tokens)

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

### `workflow_run` (~48 tokens)

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

Input parameters:

- `input` (object): Optional input data for the workflow
- `workflow_id` (string, required): Workflow ID to execute

### `workflow_stats` (~23 tokens)

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

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/alessandro114-scala-ai-os/scala-mcp-server#diagnostics

## Score history

- 2026-11-05: 74
- 2026-11-04: 73
- 2026-11-03: 73
- 2026-11-02: 72
- 2026-11-01: 72
- 2026-10-31: 72
- 2026-10-30: 71
- 2026-10-29: 71
- 2026-10-28: 70
- 2026-10-27: 70
- 2026-10-26: 69

## Common questions

### What is the io.github.Alessandro114/scala-ai-os MCP server?

io.github.Alessandro114/scala-ai-os is an MCP server listed in the public MCP registry as 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. This page covers its npm package (scala-mcp-server).

### Is the io.github.Alessandro114/scala-ai-os MCP server safe to use?

io.github.Alessandro114/scala-ai-os scores 74 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 5 November 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the io.github.Alessandro114/scala-ai-os MCP server expose?

io.github.Alessandro114/scala-ai-os exposes 31 tools: search_companies, lookup_company, list_countries, check_credits, crm_list_contacts, and 26 more. Their descriptions and schemas cost roughly 1,875 tokens of context every time the server is loaded.

### Is the io.github.Alessandro114/scala-ai-os MCP server still maintained?

io.github.Alessandro114/scala-ai-os is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the io.github.Alessandro114/scala-ai-os MCP server under?

io.github.Alessandro114/scala-ai-os declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- npm package: https://www.npmjs.com/package/scala-mcp-server
- Socket report: https://socket.dev/npm/package/scala-mcp-server
- Repository: https://github.com/Alessandro114/scala-mcp-server
- Changelog RSS feed: https://verifymcp.io/servers/alessandro114-scala-ai-os/scala-mcp-server.xml
- Changelog JSON feed: https://verifymcp.io/servers/alessandro114-scala-ai-os/scala-mcp-server.json
- HTML version of this page: https://verifymcp.io/servers/alessandro114-scala-ai-os/scala-mcp-server