# VAT.SUPPORT — Model Context Protocol (MCP) Server

[![MCP Protocol](https://img.shields.io/badge/MCP-2024--11--05-blue.svg)](https://modelcontextprotocol.io/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Status](https://img.shields.io/badge/Status-Active%20%26%20Verified-success.svg)](https://vat.support/developers/)

Official [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for **[VAT.SUPPORT](https://vat.support)** — the European Union & United Kingdom statutory VAT compliance and audit engine.

This server equips AI agents (Claude, Cursor, Windsurf, Arcade.dev, Cline) with real-time tax determinations, sub-100ms VIES entity validation, and statutory Art. 196 reverse-charge audit certificates.

---

## 🛠 Available Tools

### 1. `reverse_charge_certificate`
Evaluates statutory eligibility under **Art. 196 EU VAT Directive (2006/112/EC)** for cross-border B2B invoices between EU Member States.
- **Inputs:** `supplier_country` (ISO-2), `customer_country` (ISO-2), `customer_vat_id`, `service_type`.
- **Output:** Printable certificate with audit token, statutory article citation, and public verification URL.

### 2. `vat_number_check`
Validates European Union (EU-27) and United Kingdom (GB) VAT numbers in real-time against **European Commission VIES** and **HMRC**.
- **Inputs:** `vat_id` (e.g. `DE123456789`, `FR12345678901`, `GB123456789`).
- **Output:** Validity flag, registered company legal name, official address, and consultation number.

### 3. `vat_rate_lookup`
Fetches verified standard, reduced, super-reduced, and zero rates synced from the **European Commission TEDB** (Taxes in Europe Database).
- **Inputs:** `country` (ISO-2), `rate_type` (`standard` | `reduced` | `super_reduced` | `zero` | `parking`).

### 4. `vat_registration_check`
Determines whether a cross-border seller is legally required to register for VAT in a destination country or qualifies for the Pan-EU One Stop Shop (€10,000 threshold).
- **Inputs:** `country`, `customer_type` (`B2C` | `B2B` | `MIXED`), `annual_revenue_eur`, `sale_countries`, `supply_types`.

### 5. `vat_compliance_full`
Executes a comprehensive 10-point EU statutory VAT audit, returning a 0–100 compliance index, risk band, and Article citations.

---

## 🚀 Quick Setup

### Option A: Streamable HTTP (Remote / No Installation)
You can connect directly to the live hosted endpoint without installing any local code:

**Endpoint:** `https://vat.support/api/mcp`  
**Transport:** `streamable-http`

#### Cursor (`.cursor/mcp.json`)
```json
{
  "mcpServers": {
    "vat-support": {
      "url": "https://vat.support/api/mcp",
      "transport": "streamable-http"
    }
  }
}
```

#### Windsurf (`~/.codeium/windsurf/mcp_config.json`)
```json
{
  "mcpServers": {
    "vat-support": {
      "url": "https://vat.support/api/mcp",
      "transport": "streamable-http"
    }
  }
}
```

#### Arcade.dev
In **Arcade.dev**, navigate to **Servers** → **Add Server**:
- **Name:** `vat-support`
- **URI:** `https://vat.support/api/mcp`
- **Type:** `MCP`

---

### Option B: Local Stdio (Python)
Clone this repository and run locally:

```bash
git clone https://github.com/vmalyshev1/vat-support-mcp.git
cd vat-support-mcp
```

#### Claude Desktop (`claude_desktop_config.json`)
```json
{
  "mcpServers": {
    "vat-support": {
      "command": "python3",
      "args": ["/path/to/vat-support-mcp/server.py"]
    }
  }
}
```

---

### Option C: Docker
```bash
docker build -t vat-support-mcp .
docker run -i --rm vat-support-mcp
```

---

## 📚 Machine Readable Specs
- **LLM Manifest:** https://vat.support/llms.txt
- **Extended Machine Spec:** https://vat.support/llms-full.txt
- **Developer Documentation:** https://vat.support/developers/

## 📄 License
MIT License — Copyright (c) 2026 VAT.SUPPORT