Schema | MCP Buste Paga

MCP Buste Paga

Describes the environment variables required to run the server.

Name	Required	Description	Default
No arguments

Features and capabilities supported by this server

Capability	Details
`tools`	{ "listChanged": false }
`prompts`	{ "listChanged": false }
`resources`	{ "subscribe": false, "listChanged": false }
`experimental`	{}

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.

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

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.

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/morettimarco/MCP-Buste-Paga'

If you have feedback or need assistance with the MCP directory API, please join our Discord server