# AgentStall ZA

> Pay-per-call African and global data for AI agents. Public holidays and business-day maths for 220+ countries (pass any ISO country code), domain lookups (RDAP/WHOIS, DNS, email security) and exchange rates. For South Africa, Nigeria, Kenya, Egypt, Ghana, Morocco, Rwanda, Uganda, Tanzania, Mauritius and Botswana (country=ZA/NG/KE/EG/GH/MA/RW/UG/TZ/MU/BW): verified holiday calendars, data-breach reporting obligations with computed deadlines, official-domain and phishing checks (revenue authorities, central banks, banks, M-Pesa and MoMo), and email-spoofing scorecards. South Africa also: government tenders, SARS deadlines, school terms, SARB rates and ID, tax, company, bank and phone checks. No account or API key. Each call is paid in USDC with the x402 protocol.

Payment: x402 v2, scheme "exact", network eip155:8453 (Base mainnet), asset USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, payTo 0xA5b46001f5fAAfA9d7bB4efeEA6C724d52567a02.

## How to buy (HTTP)
1. GET the endpoint. You receive HTTP 402 with a base64 PAYMENT-REQUIRED header (the same JSON is in the body).
2. Sign an EIP-3009 USDC authorization for the amount in accepts[0] (any x402 client does this, e.g. @x402/fetch).
3. Repeat the GET with a base64 PAYMENT-SIGNATURE header. You receive HTTP 200, the JSON result and a PAYMENT-RESPONSE header with the transaction hash.
Bad input: the 402 body includes an inputError hint, and a paid request with bad input returns HTTP 400 without charging.

## How to buy (MCP)
Streamable-HTTP MCP server: https://agentstall.padawanconsulting.com/mcp . Call a tool; it returns isError with PaymentRequired in structuredContent. Retry with params._meta["x402/payment"]. Tool agentstall_catalog is free.

## Products

### Calendar
- [Public holidays API: 220+ countries incl. India, UAE, Saudi Arabia, with verified African calendars](https://agentstall.padawanconsulting.com/v1/holidays?year=2026&country=KE): $0.001 USDC. Public holidays for any country and year (220+ countries by ISO code), with date and English name. Covers the US, UK, Europe, India, UAE, Saudi Arabia, Pakistan, China, Japan, Brazil and all of Africa. South Africa, Nigeria, Kenya, Egypt, Ghana and 6 more African countries use AgentStall's verified calendars with observed days and declared Islamic holidays. Free open sources: Nager.Date and date-holidays. Useful for scheduling, payroll and deadlines. Params: year: Calendar year (South Africa 1995-2100; 10 verified African countries 2026-2027; other countries 2000-2040); country (optional): 2-letter ISO country code, e.g. ZA (default), NG, KE, EG, IN, AE, SA, US, GB, DE, BR, CN (220+ countries). Verified calendars for ZA, NG, KE, EG, GH, MA, RW, UG, TZ, MU and BW. MCP tool: za_public_holidays.
- [Business day checker: is a date a working day? 220+ countries](https://agentstall.padawanconsulting.com/v1/business-day?date=2026-11-04&country=KE): $0.001 USDC. Checks whether a date is a business (working) day in any of 220+ countries and says why not: weekend or which public holiday. Returns the next and previous business days. Handles local weekends (Friday-Saturday in Saudi Arabia, Egypt and Israel) and observed holidays, with verified calendars for South Africa, Nigeria, Kenya, Egypt and 7 more African countries. Useful for payment, settlement and delivery dates. Params: date: Date in YYYY-MM-DD; country (optional): 2-letter ISO country code, e.g. ZA (default), NG, KE, EG, IN, AE, SA, US, GB, DE, BR, CN (220+ countries). Verified calendars for ZA, NG, KE, EG, GH, MA, RW, UG, TZ, MU and BW. MCP tool: za_is_business_day.
- [Business days calculator: add or subtract working days, 220+ countries](https://agentstall.padawanconsulting.com/v1/add-business-days?start=2026-12-23&days=5&country=KE): $0.002 USDC. Business days calculator: adds or subtracts working days from a date in any of 220+ countries, skipping weekends and public holidays, and lists the holidays skipped. Local weekends supported (e.g. Friday-Saturday in Saudi Arabia and Egypt). Verified calendars for South Africa and 10 African countries. Useful for payment terms such as 'net 5 business days', notice periods, SLAs, delivery estimates and legal deadlines. Params: start: Start date, YYYY-MM-DD; days: Business days to add, -1000 to 1000; country (optional): 2-letter ISO country code, e.g. ZA (default), NG, KE, EG, IN, AE, SA, US, GB, DE, BR, CN (220+ countries). Verified calendars for ZA, NG, KE, EG, GH, MA, RW, UG, TZ, MU and BW. MCP tool: za_add_business_days.
- [Count business days between two dates (working days calculator), 220+ countries](https://agentstall.padawanconsulting.com/v1/count-business-days?from=2026-12-01&to=2026-12-31&country=KE): $0.002 USDC. Working days calculator: counts the business days between two dates in any of 220+ countries, excluding weekends and public holidays, and lists the holidays excluded. Local weekends supported. Verified calendars for South Africa, Nigeria, Kenya, Egypt, Ghana and 6 more African countries. Useful for SLAs, turnaround times, leave days and deadlines measured in business days. Params: from: Start date, YYYY-MM-DD (exclusive); to: End date, YYYY-MM-DD (inclusive), within 5 years of 'from'; country (optional): 2-letter ISO country code, e.g. ZA (default), NG, KE, EG, IN, AE, SA, US, GB, DE, BR, CN (220+ countries). Verified calendars for ZA, NG, KE, EG, GH, MA, RW, UG, TZ, MU and BW. MCP tool: za_count_business_days.
- [South African school calendar: school terms and school holidays 2026-2027](https://agentstall.padawanconsulting.com/v1/school-calendar?date=2026-11-04&year=2026): $0.003 USDC. South African public school calendar: term dates and school holidays for 2026 and 2027 from the Department of Basic Education, special school holidays, and whether a given date is a school day. Useful for family travel, childcare, events and education planning in South Africa. Params: date (optional): Optional date (YYYY-MM-DD) to check whether it is a school day; year (optional): Optional year (2026-2027) to list the terms; defaults to the date's year or the current year. MCP tool: za_school_calendar.

### Compliance
- [South African tax deadlines (SARS): PAYE, VAT, provisional tax and filing season](https://agentstall.padawanconsulting.com/v1/sars-deadlines?from=2026-10-22&to=2026-12-31): $0.005 USDC. South African tax deadlines from SARS between two dates: EMP201 PAYE/UIF/SDL payments, VAT201 returns, provisional tax (IRP6), EMP501 reconciliations and income tax filing-season deadlines, already moved to the previous business day where SARS rules require it. Useful for payroll, bookkeeping, accounting and tax compliance reminders in South Africa. Params: from (optional): Start date YYYY-MM-DD (default: today); to (optional): End date YYYY-MM-DD, at most 400 days after 'from' (default: from + 90 days). MCP tool: za_sars_deadlines.

### Government tenders
- [South African government tenders: search open tenders and RFQs (eTenders)](https://agentstall.padawanconsulting.com/v1/tenders?q=cleaning+services&open=true&closing_within_days=14&category=services&buyer=Municipality&limit=10): $0.005 USDC. South African government tenders and RFQs: searches open tenders from national and provincial departments, municipalities and state-owned companies published on the National Treasury eTenders portal. Filter by keyword, closing date, category and buyer. Returns tender number, description, buyer, procurement method, opening and closing dates, and tender document links. Updated every 3 hours. Params: q (optional): Keywords, e.g. 'security services' or 'laptops -lease'; open (optional): Only tenders still open (default true); closing_within_days (optional): Only tenders closing within N days (1-365); category (optional): goods, services, works or consultingServices; buyer (optional): Part of the buyer's name, e.g. 'Municipality' or 'Transnet'; limit (optional): Maximum results, 1-50 (default 20). MCP tool: za_tender_search.

### Money
- [South African interest rates, inflation and rand exchange rates (SARB)](https://agentstall.padawanconsulting.com/v1/rates): $0.005 USDC. South African interest rates, inflation and rand exchange rates from the South African Reserve Bank (SARB): repo rate, prime lending rate, CPI and PPI inflation, and rand (ZAR) per US dollar, pound, euro and yen, each with its as-of date. Useful for loan and interest calculations, pricing in rand and economic context. MCP tool: za_sarb_rates.
- [South African bank universal branch codes (Capitec, FNB, Absa, Standard Bank, Nedbank)](https://agentstall.padawanconsulting.com/v1/bank-branch-codes?bank=Capitec): $0.001 USDC. South African bank universal branch codes for EFT payments and debit orders: Absa, Capitec, FNB, Nedbank, Standard Bank, TymeBank, Discovery Bank, Investec, African Bank and Bidvest Bank. Look up one bank or list all. Useful for completing South African bank payment details. Params: bank (optional): Optional bank name or code to look up. MCP tool: za_bank_branch_codes.
- [Currency exchange rates API: 150+ currencies incl. rand, naira, shilling, rupee](https://agentstall.padawanconsulting.com/v1/exchange-rates?base=USD&symbols=ZAR%2CNGN%2CKES%2CEGP%2CGHS&amount=100): $0.002 USDC. Currency exchange rates and conversion for 150+ currencies, updated daily: USD, EUR, GBP, CNY, INR and every African currency, including South African rand (ZAR), Nigerian naira (NGN), Kenyan shilling (KES), Egyptian pound (EGP), Ghanaian cedi (GHS) and CFA francs. Any base currency, optional amount conversion. Mid-market reference rates from an open daily dataset, not official central-bank fixings. Useful for pricing, invoices and reports. Params: base (optional): Base currency code (default USD); symbols (optional): Comma-separated currency codes to return (default: 18 African currencies plus USD, EUR, GBP, CNY, INR); amount (optional): Optional amount in the base currency to convert. MCP tool: exchange_rates.

### Checks
- [South African ID number check: validate and decode an SA ID number](https://agentstall.padawanconsulting.com/v1/validate-id?id=8001015009087): $0.005 USDC. South African ID number validation: checks a 13-digit SA ID number (date of birth, citizenship digit and Luhn checksum) and decodes date of birth, age, gender and citizenship status. Structural check only, with no Home Affairs lookup; the number is not stored. Useful for KYC and onboarding forms and for catching typos. Params: id: 13-digit SA ID number. MCP tool: za_validate_id_number.
- [South African VAT number and income tax number check (SARS format)](https://agentstall.padawanconsulting.com/v1/validate-tax-number?number=0001339050): $0.002 USDC. South African tax number validation: checks a 10-digit SARS VAT registration number or income tax reference number (format and modulus-10 check digit) and says which type it is. Format check only, not a SARS registration lookup; nothing is stored. Useful for invoices, supplier onboarding and form validation. Params: number: VAT or income tax number; spaces, dashes and slashes are ignored. MCP tool: za_validate_tax_number.
- [South African company registration number check (CIPC)](https://agentstall.padawanconsulting.com/v1/validate-company-number?number=2015%2F123456%2F07): $0.002 USDC. South African company registration number check: validates a CIPC registration number (YYYY/NNNNNN/NN) and decodes the registration year and entity type, such as (Pty) Ltd, Ltd, NPC, Inc, CC, co-operative or SOC. Format check only, not a CIPC status lookup. Useful for supplier onboarding, invoices and tender paperwork. Params: number: Registration number, e.g. 2015/123456/07. MCP tool: za_validate_company_number.
- [South African phone number formatting and validation (+27)](https://agentstall.padawanconsulting.com/v1/normalize-phone?number=082+123+4567): $0.001 USDC. South African phone number formatting and classification: converts an SA number in any common format to international +27 (E.164) and local formats, and says whether it is mobile, landline (with area for major cities), toll-free, VoIP or premium-rate. Useful for cleaning contact lists, SMS and WhatsApp messaging, and form validation. Params: number: Phone number in any common format, e.g. 082 123 4567 or +27 11 555 1234. MCP tool: za_normalize_phone.

### Cyber security
- [Data breach and cyber incident reporting rules: South Africa, Nigeria, Kenya, Egypt and 7 more](https://agentstall.padawanconsulting.com/v1/incident-reporting?country=ZA&critical_infrastructure=false&sector=bank&personal_info=true&role=responsible_party&material=true&aware_at=2026-10-22T08%3A15%2B02%3A00&classified_at=2026-10-22T11%3A00%2B02%3A00&jse_listed=false): $0.01 USDC. Data breach and cyber incident reporting obligations in South Africa, Nigeria, Kenya, Egypt, Ghana, Morocco, Rwanda, Uganda, Tanzania, Mauritius and Botswana: which regulators and people must be notified, the legal deadline (such as 72 hours) and the computed due time from discovery. Covers POPIA and FSCA/PA rules in South Africa, NDPA and ngCERT in Nigeria, and Kenya's Data Protection Act. Triage guidance, not legal advice. Params: country (optional): Country code: ZA (default), NG, KE, EG, GH, MA, RW, UG, TZ, MU or BW; critical_infrastructure (optional): Outside South Africa: are you a designated critical / vital infrastructure operator? Omit if unknown; sector (optional): South Africa only. Organisation type: general (any private business), bank, mutual_bank, insurer, financial_other (other FSCA-regulated institutions covered by Joint Standard 1 of 2023 or 2 of 2024, e.g. market infrastructures, certain FSPs, pension funds), public_body, ecsp (electronic communications service provider). Default general; personal_info (optional): Was personal information accessed or acquired by an unauthorised person? Omit if unknown; role (optional): responsible_party (default) or operator (you process the data for someone else); material (optional): Financial institutions: has the incident been classified as material? Omit if not yet assessed; aware_at (optional): When you discovered the compromise (ISO 8601; no offset = UTC+2); classified_at (optional): Financial institutions: when the incident was classified as material (ISO 8601); jse_listed (optional): Is the organisation listed on the JSE? Default false. MCP tool: za_incident_reporting_obligations.
- [Phishing link checker for Africa: fake bank, tax and mobile-money sites (SARS, KRA, M-Pesa)](https://agentstall.padawanconsulting.com/v1/official-domain-check?url=https%3A%2F%2Fsars-efiling-refund.com%2Flogin): $0.005 USDC. Phishing URL and fake-website check for Africa: compares a link or domain with the official domains of about 130 tax authorities (SARS, KRA, FIRS, GRA), central banks, government services, banks, mobile money (M-Pesa, MTN MoMo, OPay) and telecoms in South Africa and 10 other African countries, and flags lookalike domains, typosquats, brand names in unofficial domains and newly registered domains. Params: url: A link or domain, e.g. https://sars-refund-portal.com/login or capitecbank.co.za. MCP tool: za_official_domain_check.
- [Email security check: DMARC, SPF, DNSSEC and MTA-STS grade with spoofing risk](https://agentstall.padawanconsulting.com/v1/email-security?domain=sars.gov.za): $0.003 USDC. DMARC and SPF checker for any domain: grades DMARC, SPF, DNSSEC, MTA-STS and TLS-RPT from public DNS (score and A-F grade), says how easily fake email could be sent in the domain's name and lists the fixes. Also returns daily-updated email security scorecards ranking banks, governments, regulators and telecoms in South Africa, Nigeria, Kenya, Egypt, Ghana and 6 more African countries. Params: domain (optional): Domain to check, e.g. example.co.za (use this or sector); sector (optional): Leave empty when checking a domain. For a ranked scorecard instead, give a sector: banks_insurers, government, metros, regulators_soe, telecoms, all (e.g. banks_insurers); country (optional): Scorecard only: ZA (default), NG, KE, EG, GH, MA, RW, UG, TZ, MU, BW, or ALL. MCP tool: za_email_security.
- [Domain WHOIS and RDAP lookup: registrar, age, expiry, DNS, email security, phishing risk](https://agentstall.padawanconsulting.com/v1/domain-intel?domain=example.com): $0.005 USDC. WHOIS / RDAP domain lookup: registrar, registration and expiry dates, domain age, status, nameservers and DNSSEC from the registry, plus DNS records, email security grade (DMARC, SPF, MTA-STS) and plain-language risk flags such as newly registered, expiring soon or easily spoofed, with impersonation signals for African banks, tax authorities and mobile money. Useful for phishing triage, vendor due diligence and research. Params: domain: Domain or link, e.g. example.com or https://kra-itax-refund.com/login. MCP tool: domain_intel.

## Machine-readable
- [Catalog JSON](https://agentstall.padawanconsulting.com/)
- [OpenAPI 3.1](https://agentstall.padawanconsulting.com/openapi.json)
- [x402 resource list](https://agentstall.padawanconsulting.com/.well-known/x402)
- [Health and facilitator status](https://agentstall.padawanconsulting.com/health)