MCP Buste Paga
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ingest_payslipsA | Scan a directory for PDF payslips, parse them, and store in the database. Skips already-ingested files (SHA-256 deduplication). Returns a JSON summary: total files, ingested, duplicates skipped, failures. |
| get_employee_summaryA | Get employee and company information from the database. Returns the employee profile (name, fiscal code, hire date, role) and company details, plus the number of payslips stored. |
| get_salary_history_toolA | Get salary history ordered by most recent month first. Args: year: Filter to a specific year (optional). limit: Maximum number of months to return (default 12). Returns a JSON array with mese, anno, totale_competenze, totale_ritenute, netto_a_pagare, and lordo_anno for each month. |
| get_payslip_details_toolA | Get the full details of a specific payslip by month and year. Args: mese: Month number (1-12). anno: Year (e.g. 2026). Returns the payslip master record plus all line items (voci) showing what was paid or deducted (base pay, overtime, taxes, etc.). |
| search_payslip_itemsA | Search payslip line items by description keyword. Searches the voci_corpo_busta table using SQL LIKE matching. Groups and sums results by month/year. Args: keyword: Search term (e.g. "Straordinario", "Ferie", "Ticket", "Commissioni"). start_year: Filter from this year (optional). end_year: Filter up to this year (optional). Returns per-month breakdown and grand totals for competenze and ritenute. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| use_interpretation_guide | Load the full payslip interpretation guide into the conversation. Use this prompt before analysing payslip data to ensure correct interpretation of all fields, voce codes, and validation rules. |
| verify_payslip | Step-by-step verification workflow for a specific payslip. Instructs the agent to fetch the payslip and run all 9 validation checks from the interpretation guide, showing the math for each. Args: mese: Month number (1-12). anno: Year (e.g. 2026). |
| analyze_annual_salary | Annual salary analysis workflow for a given year. Instructs the agent to fetch and correctly interpret a full year of salary data, using December's conguaglio for definitive annual figures. Args: anno: Year to analyse (e.g. 2025). |
| compare_months | Side-by-side comparison of two payslip months. Instructs the agent to normalise for one-off items before comparing, so structural salary changes are not confused with variable pay. Args: mese1: First month (1-12). anno1: First year. mese2: Second month (1-12). anno2: Second year. |
| search_and_summarize | Search for a payslip item and produce a structured annual summary. Instructs the agent to call search_payslip_items and present results grouped by year with totals and absence flags. Args: keyword: Search term (e.g. "Commissioni", "Straordinario", "Ticket"). |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| interpretation_guide | Full interpretation guide for reading and validating Italian INAZ payslip data. Covers all tools, field meanings, voce codes, IRPEF/INPS validation chains, conguaglio logic, and communication guidelines. |
| voce_codes_reference | Compact voce code reference table for Italian INAZ payslips. Lists all known codes with their description, category, INPS/IRPEF tax treatment, and key calculation notes. Use this for fast lookup during payslip analysis without loading the full interpretation guide. |
TDQS
Scored across 5 tools
Each tool targets a distinct operation: ingestion, employee profile, salary summary, payslip details, and keyword search. There is no apparent overlap; even the two 'get' tools serve clearly separate purposes (aggregate history vs. individual payslip detail).
Most names follow a verb_noun pattern, but two tools have the '_tool' suffix (get_salary_history_tool, get_payslip_details_tool) while others do not. This is a minor inconsistency that doesn't impede understanding, but it breaks the pattern slightly.
With exactly 5 tools, the set is well-scoped for a payslip management server. Each tool addresses a necessary step (ingestion, querying summaries, details, and search) without redundancy or bloat.
The server covers the core lifecycle: import payslips, view employee context, review salary history, inspect specific payslips, and search line items. Minor gaps exist (e.g., no list of all payslips as a lightweight endpoint, no update/delete), but the core functionality is complete for typical read-only and ingestion use cases.