Skip to content
MCP server

Africa Compliance Data

African holidays, VAT, withholding tax, tax IDs and filing dates for 54 countries

Status and history

Answered our latest tool-list check yesterday with 19 tools. It will be marked verified after 3 successful checks in 7 days.

Install
Pricing
Freemium
Platforms
API
Runs
Remotely
Version
1.0.2
Listing updated
3 days ago

About Africa Compliance Data

Africa Compliance Data is a freemium MCP server for security. It runs as a hosted remote server, so there is nothing to install locally.

Each answer carries a source link, legal basis, effective date, last-checked date and a confidence level, and coverage is marked ready, partial or gap per country and feature. A daily monitor watches 503 sources, mostly official. Holiday calendars run 2025 to 2030 for 51 countries; Islamic holidays stay estimated until announced. Tax coverage includes VAT for 52 countries, withholding for 51, tax ID format checks for 42 and treaty rates for 40, partly.

The MCP server offers read-only tools with the same data as the API, and needs an x-api-key header (Claude Code and Cursor work). Free covers holidays and business days at 3,000 requests a month; tax data needs Essentials, Pro or Compliance. It is reference data, not tax advice.

Install

Run in a terminal

claude mcp add --transport http africa-compliance-data https://api.africacompliancedata.com/mcp

Add to Settings → Connectors → Add custom connector

https://api.africacompliancedata.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "africa-compliance-data": {
      "url": "https://api.africacompliancedata.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "africa-compliance-data": {
      "type": "http",
      "url": "https://api.africacompliancedata.com/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "africa-compliance-data": {
      "serverUrl": "https://api.africacompliancedata.com/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "africa-compliance-data": {
      "type": "http",
      "url": "https://api.africacompliancedata.com/mcp"
    }
  }
}

Tools this server provides (19)

Read directly from the server.

list_countries
List the 54 African countries covered, with currency and per-feature coverage (ready / partial / gap).
get_public_holidays
Public holidays for a country and year, with status (rule / confirmed / estimated / observed / bridge) and sources. Islamic holidays are estimated until a reviewer has verified the announcement (delays are possible).
get_holiday_watch
Across countries: holidays whose date depends on an announcement (Eid, Mawlid and other moon-sighted holidays, ad-hoc days off) from a week ago to N days ahead, with status estimated (not announced or not yet verified) or confirmed (with its source), and who announces them (Developer, Pro and Compliance plans).
get_changes
The change log: one entry per changed value, oldest first, with the old and new value, kind (law_change, correction, new_source, coverage), the date a law change applies from, and its source. Optional: since (YYYY-MM-DD) and one country. Developer and Pro plans: holiday changes; Compliance: every change.
is_business_day
Whether a date is a working day in a country (weekend and national public holidays).
count_business_days
Number of working days between two dates (inclusive) in a country, and the holidays skipped.
add_business_days
Date that is N working days after (or before, if negative) a start date in a country.
get_vat
VAT/GST/TVA/IVA standard and other rates, registration threshold and legal basis for a country. With 'date', also the standard rate in force on that date (dated history with the law that set it).
get_vat_history
Every standard VAT rate period for a country (from, to, rate) with the law that set it, for audits, refunds and re-invoicing.
get_withholding_tax
Withholding tax rates (resident / non-resident) by payment type: dividends, interest, royalties, rent, services, fees... With 'recipient_country', also the tax-treaty maximum rates for a payment to that country.
calculate_withholding_tax
The tax to withhold on one payment from a country to a recipient resident in another country (or the same one): applies the domestic rate and, for a non-resident, the tax-treaty maximum (the lower one), and returns the rate, the amount withheld and the net payment, with the sources. With amount_is 'net', grosses the payment up. Where the data cannot decide (treaty rates by condition such as 5/15,
get_tax_treaties
Double tax treaties of a country (as the paying country): maximum withholding rates on dividends, interest, royalties and technical fees for each treaty partner, with conditions, dates in force and the official text.
get_einvoicing
A country's e-invoicing or fiscalisation requirement: system (e.g. eTIMS, EFRIS, MBS), tax authority, status (mandatory, phased, voluntary, pilot, planned, unclear, none_found), model (clearance, real-time reporting, fiscal device), dated phases (who must comply from when), legal basis and source, and the authority's published list of accredited integrators where one exists.
get_finance_law_changes
Plain-English digest of a country's latest finance law: business-relevant tax changes (VAT, withholding, corporate, payroll, procedure) with effective dates and article references. Unofficial summary; the cited law prevails (Compliance plan).
get_payroll_tax
Income tax bands on employment income for resident employees (PAYE / ITS / IRPP...): the bands, tax-free threshold and reliefs in force on a date (default today), and every dated period with its legal basis, source and confidence. Reference data only, no salary calculation.
get_social_security
Statutory contributions on pay (pension, social security, health, housing, work injury, training and other payroll levies): employee and employer rates, base, floor and ceiling in force on a date (default today), and every dated period with its legal basis, source and confidence.
validate_tax_id_format
Check whether a taxpayer identification number matches the country's known format. Format check only: it does not confirm registration (format_check 'partial' means a weak check on characters and length only). The number is not stored.
get_filing_deadlines
Tax filing and payment due dates falling in a given month (VAT, PAYE, withholding, corporate tax), adjusted for weekends and holidays where the country's rule (weekend_adjust) or the item's own rule is known; otherwise the statutory date with adjusted: false.
get_country_profile
All compliance reference data for one country: holiday rules, announcement authority, VAT, withholding tax, tax ID format, filing deadlines and sources (tax parts on the Compliance plan, and on Pro for the countries of its country pack).

What it does

Holidays and business days
Counts or adds working days using weekend rules.
VAT and withholding
Standard and reduced VAT and withholding rates.
Tax ID checks
Validates number format, not registration.
Filing deadlines
Gives due dates for VAT, PAYE and corporate tax.
Source citations
Every value links its source.

Good for

  • Ask when VAT is due in Ghana
  • Count working days in Morocco
  • Check withholding on royalties
  • Validate a supplier's tax ID format

Pricing

Freemium

Free plan for holidays; tax data on paid plans, prices not listed here

Prices change. Check africacompliancedata.com before you buy.

Africa Compliance Data FAQ

Is there a free plan?

Yes; holidays and business days, 3,000 requests a month.

Does it prove a tax ID is registered?

No, format only.

Is it tax advice?

No.

Is Africa Compliance Data free?

Africa Compliance Data has a free plan, with paid plans for more usage or features.

How do I add Africa Compliance Data to Claude Code?

Run this command in your terminal: claude mcp add --transport http africa-compliance-data https://api.africacompliancedata.com/mcp

What are the best alternatives to Africa Compliance Data?

The closest alternatives to Africa Compliance Data are REA, Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe and Tapetide - Indian Stock Market MCP.

Alternatives to Africa Compliance Data

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  3. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  4. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  5. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  6. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools