manifest.json

{
  "manifest_version": "0.3",
  "name": "fattureincloud",
  "display_name": "FattureInCloud",
  "version": "2.0.0",
  "description": "Manage your FattureInCloud account from Claude: invoices, e-invoicing (SDI), clients, cost / revenue centers, and supplier documents.",
  "long_description": "FattureInCloud is the leading Italian SaaS for electronic invoicing. Italy mandates B2B/B2C e-invoicing through the Sistema di Interscambio (SDI) — this community-built MCP server brings AI-assisted billing to that compliance-driven workflow. Read and write operations are supported across invoices, credit notes, proformas, received documents, clients, and cost / revenue centers, plus a yearly financial dashboard. API calls go directly from the user's machine to FattureInCloud's API; no data is routed through third-party servers. This is an unofficial integration. Not affiliated with, endorsed by, or sponsored by TeamSystem S.p.A., owner of the FattureInCloud trademark.",
  "author": {
    "name": "Mediaform s.c.r.l.",
    "email": "assistenza@mediaform.it",
    "url": "https://media-form.it"
  },
  "homepage": "https://github.com/aringad/fattureincloud-mcp",
  "repository": {
    "type": "git",
    "url": "https://github.com/aringad/fattureincloud-mcp.git"
  },
  "license": "MIT",
  "icon": "icon.png",
  "keywords": [
    "invoicing",
    "italy",
    "sdi",
    "fattureincloud",
    "accounting",
    "fattura-elettronica",
    "e-invoicing"
  ],
  "privacy_policies": [
    "https://media-form.it/privacy-policy.html"
  ],

  "server": {
    "type": "python",
    "entry_point": "server.py",
    "mcp_config": {
      "command": "python3",
      "args": ["${__dirname}/server.py"],
      "env": {
        "PYTHONPATH": "${__dirname}/lib",
        "FIC_ACCESS_TOKEN": "${user_config.api_token}",
        "FIC_COMPANY_ID": "${user_config.company_id}",
        "FIC_SENDER_EMAIL": "${user_config.sender_email}"
      }
    }
  },

  "user_config": {
    "api_token": {
      "type": "string",
      "title": "FattureInCloud API Token",
      "description": "Personal API access token. Get it from FattureInCloud → Settings → API and Integrations → Manual Token. Starts with 'a/'.",
      "sensitive": true,
      "required": true
    },
    "company_id": {
      "type": "string",
      "title": "FattureInCloud Company ID",
      "description": "Numeric company ID. Visible in the FattureInCloud URL after /c/ once you have selected the company.",
      "required": true
    },
    "sender_email": {
      "type": "string",
      "title": "Sender Email (optional)",
      "description": "Mailbox used as sender by the send_email tool when sending courtesy copies of invoices. Leave empty if you don't plan to use send_email.",
      "required": false
    }
  },

  "tools": [
    {"name": "list_invoices", "description": "List issued documents (invoices / credit notes / proformas) for a year, with optional month, type, and free-text query filters."},
    {"name": "get_invoice", "description": "Get full detail of a single document by ID (invoice, credit note, or proforma)."},
    {"name": "get_pdf_url", "description": "Return the PDF URL and the FattureInCloud web link for a document."},
    {"name": "list_clients", "description": "List clients with optional name / VAT filter."},
    {"name": "get_company_info", "description": "Get info about the connected FattureInCloud company."},
    {"name": "create_client", "description": "Create a new client in the registry."},
    {"name": "update_client", "description": "Update an existing client. Only the fields passed are modified."},
    {"name": "create_invoice", "description": "Create a draft invoice with automatic SDI code lookup. Optional revenue_center."},
    {"name": "create_credit_note", "description": "Create a draft credit note. Positive amounts in input, negated automatically. Optional revenue_center."},
    {"name": "create_proforma", "description": "Create a draft proforma (cannot be sent to SDI). Optional revenue_center."},
    {"name": "convert_proforma_to_invoice", "description": "Convert a proforma into a draft electronic invoice. By default the source proforma is deleted (set keep_proforma=true to retain it)."},
    {"name": "update_document", "description": "Partial update of a draft document (invoice / credit note / proforma). Only fields passed are changed. Fails if the document was already sent to SDI."},
    {"name": "duplicate_invoice", "description": "Duplicate an invoice with a new date, optional payment-days override, and optional description text replacements."},
    {"name": "delete_invoice", "description": "Delete a draft document. Irreversible."},
    {"name": "send_to_sdi", "description": "Send an invoice or credit note to the Italian Sistema di Interscambio (SDI). Irreversible."},
    {"name": "get_invoice_status", "description": "Read the e-invoice / SDI status of a document."},
    {"name": "send_email", "description": "Send a courtesy copy of a document by email. Requires the FIC_SENDER_EMAIL env var."},
    {"name": "list_received_documents", "description": "List received (supplier) documents — expenses or received credit notes — for a year, with optional month and free-text query."},
    {"name": "get_situation", "description": "Yearly financial dashboard: net revenue (invoices minus credit notes), collected, outstanding, costs, margin. Optional client filter."},
    {"name": "check_numeration", "description": "Verify invoice numbering continuity for a given year. Reports gaps."},
    {"name": "list_cost_centers", "description": "List configured cost AND revenue centers (deduplicated union of the two FIC API endpoints, matching the 'Analisi centri c/r' view in FattureInCloud's UI). Validation on issued document mutations matches the input against revenue_centers only; validation on received document mutations matches against cost_centers only."},
    {"name": "get_received_document", "description": "Get full detail of a single received document by ID."},
    {"name": "create_received_document", "description": "Create a received document (expense or received credit note) with supplier, amounts, optional category and description, and optional cost_center."}
  ],

  "compatibility": {
    "platforms": ["darwin", "linux", "win32"],
    "claude_desktop": ">=0.7.0",
    "runtimes": {
      "python": ">=3.10"
    }
  }
}