# VATNode MCP

> VATNode validates international VAT numbers and audits corporate data across global jurisdictions. This server lets your AI client check if a VAT ID is active, retrieve full company metadata (like names and addresses), and pull current standard or reduced tax rates for any country instantly. It handles the entire compliance workflow without manual lookups.

## Overview
- **Category:** finance-accounting
- **Price:** Free
- **Tags:** vat-validation, tax-compliance, global-tax, business-verification, financial-data

## Description

You gotta stop doing manual lookups just to check a VAT ID or figure out tax rates. This server lets your AI client run global compliance checks right from your chat window. It’s built around core functions that handle international tax law like it's just another API call.

When you connect this, your agent immediately knows how to validate any given VAT number and pull back all the corporate data attached to it. You can use `validate_vat_number` to check if a VAT ID is valid; it doesn’t just say 'yes,' it also fetches the associated company metadata for you right away. Once that's verified, you can drill down further using `get_company_by_vat`. This tool pulls specific business registration data—names, addresses, and other core details—directly from that validated VAT number, giving you a full background on the entity.

Need to know what tax rates they gotta pay? The system handles that too. If you’re working in a specific country, `get_country_vat_rates` pulls the current standard and reduced VAT rates for that single nation instantly. For broader research, if you just need general tax intel on a whole country, use `get_country_tax_info`. It gives you additional tax information for any specified locale. If your job is market mapping and you need to see everything at once, `list_all_vat_rates` provides a comprehensive catalog of VAT rates across every single supported country out there.

It's not just about the business; it’s also about keeping track of how much you're spending. You can monitor your account limits and usage stats with `get_api_usage`. This keeps you in control, letting you know exactly what you've used on the VATNode API. Essentially, you run through a whole compliance workflow—validation, data retrieval, tax rate auditing, and resource checking—without ever leaving your terminal.

It means when you’re reviewing international business records, your agent acts like having an expert tax consultant on speed dial. You don't spend time cross-referencing spreadsheets; you just ask for the information, and it hits you clean, verified data. Whether you need to confirm a company's existence using `validate_vat_number`, grab their registered address via `get_company_by_vat`, determine local tax brackets with `get_country_vat_rates`, or map out global rates with `list_all_vat_rates`, this server handles the heavy lifting. You’re dealing in hard facts, not guesswork.

## Tools

### get_company_by_vat
Retrieves specific business data associated with an entered VAT number.

### get_country_tax_info
Pulls additional, general tax information for a specified country.

### get_api_usage
Checks your current usage statistics for the VATNode API.

### get_country_vat_rates
Gets the current standard and reduced VAT rates for one country.

### list_all_vat_rates
Provides a list of all supported countries and their associated VAT rates.

### validate_vat_number
Verifies if a given VAT number is valid and fetches the corresponding company metadata.

## Prompt Examples

**Prompt:** 
```
Validate the VAT number 'DE123456789' using VATNode.
```

**Response:** 
```
VAT number validated! The ID is valid and corresponds to a registered company in Germany. I've retrieved the company name and address. Would you like the current VAT rates for Germany as well?
```

**Prompt:** 
```
What are the standard VAT rates in 'France' (FR)?
```

**Response:** 
```
I've retrieved the VAT rates for France. The standard rate is 20%. Reduced rates of 10%, 5.5%, and 2.1% are also available for specific categories. I can assist you with more tax auditing if needed.
```

**Prompt:** 
```
List all countries with a standard VAT rate above 20%.
```

**Response:** 
```
I've scanned the global rate catalog. Countries with standard rates above 20% include Hungary (27%), Denmark (25%), and Sweden (25%). Would you like the full list of metadata for these countries?
```

## Capabilities

### Validate any VAT number
The server checks if an input VAT ID exists and retrieves associated corporate metadata for the company.

### Get company details by VAT ID
It pulls specific business registration data, like names and addresses, directly from a validated VAT number.

### Determine country tax rates
The system retrieves current standard or reduced VAT rates for one specified nation.

### List all global tax rates
It provides a full catalog of VAT rates across every supported country, useful for market research.

### Audit API usage
The server reports on your current consumption stats and account limits.

## Use Cases

### Auditing a potential acquisition target
You're vetting a company in Italy for an M&A deal. Instead of tracking down their official registry, you ask your agent to run `get_company_by_vat` using the VAT ID. The agent returns confirmed legal metadata (name, address) instantly, letting you move straight to valuation.

### Processing a new international invoice
A client in Sweden sends an invoice. You need to verify both their tax status and the correct rate. Your agent first uses `validate_vat_number` on their ID, then calls `get_country_vat_rates` for Sweden to confirm if the billed amount matches current rates.

### Mapping out global sales channels
You're launching a product and need to know the tax rules everywhere. You use `list_all_vat_rates`. The agent spits out a list of every country supported, allowing you to quickly build a matrix of required compliance checks.

### Debugging workflow quotas
Mid-day, your audit pipeline slows down. Before assuming an error, you run `get_api_usage`. The tool confirms you hit your rate limit quota and tells you exactly when the next batch of lookups will be available.

## Benefits

- Instantly validate IDs: Use `validate_vat_number` to check if a tax ID is active, getting back confirmation along with the company's name and address. No more manual lookups are needed.
- Global rate oversight: Need to know the standard or reduced VAT rates for Brazil? Just call `get_country_vat_rates`. The agent handles the query and provides the precise percentage.
- Rapid corporate background checks: Run a company audit using `get_company_by_vat` with just the VAT number. You get structured metadata, which is way faster than cross-referencing multiple government websites.
- Full market scope visibility: If you're planning expansion, use `list_all_vat_rates`. This tool shows tax rates for every supported country in one go.
- Know your limits: Check the API usage with `get_api_usage` to keep track of how many lookups you have left. It helps prevent service interruptions mid-audit.

## How It Works

The bottom line is that you tell your AI client what tax information you need; it handles running all necessary API calls to get the final result.

1. Subscribe to the VATNode server and enter your unique API Key into your AI client.
2. Ask your agent a specific tax question (e.g., 'What's the standard VAT rate in France?').
3. The agent automatically calls the correct internal tool—like `get_country_vat_rates`—and returns the clean, verified answer.

## Frequently Asked Questions

**How do I validate a VAT number using VATNode?**
You call the `validate_vat_number` tool with the ID. The server immediately tells you if it's valid and provides associated corporate metadata.

**What is the difference between `get_company_by_vat` and `validate_vat_number`?**
`validate_vat_number` runs a full check that confirms validity *and* pulls details. `get_company_by_vat` specifically targets retrieving company registration information using an already confirmed VAT number.

**Can I list all tax rates in one go with VATNode?**
Yes, use the `list_all_vat_rates` tool. It scans the global catalog and returns the current standard rate for every supported country.

**Does VATNode only check EU countries?**
No. The server supports a wide range of jurisdictions, providing global tax intelligence beyond just European Union rules.

**How do I check my usage limits using the `get_api_usage` tool?**
You access your current quota directly with `get_api_usage`. This function pulls real-time statistics on how much you've used and what your remaining calls are. It keeps your agent running without hitting unexpected rate limits.

**What authentication do I need when using VATNode in my client?**
You must provide a valid VATNode API Key for authentication. You enter this key into your AI client's configuration settings before connecting the agent. This secures your data and links all requests to your account.

**If I use `validate_vat_number` on an invalid number, what details does it provide?**
The tool reports a specific failure status rather than just saying 'no.' It tells you if the issue is format-based (wrong structure) or if the company simply doesn't exist in the registry. This detail saves time debugging bad inputs.

**When should I use `get_country_tax_info` versus getting rates via `get_country_vat_rates`?**
`get_country_tax_info` gives you the full legal context of a country's tax system. While `get_country_vat_rates` only provides percentages (like 20%), the general info tool offers details on reporting rules and local regulations.

**How do I find my VATNode API Key?**
Log in to your [**VATNode dashboard**](https://vatnode.dev/dashboard), and you will find your API Key on the main home page. Copy and paste it below.

**Can the agent validate European VAT numbers?**
Yes. VATNode supports validation for VAT numbers across the European Union and several other jurisdictions globally using official VIES data.

**Is tax rate information provided?**
Yes. The `get_country_vat_rates` tool provides current standard and reduced VAT rates, helping you audit tax obligations for different regions.