io.github.Z4KARY/upgrowth-mcp

Est-ce que io.github.Z4KARY/upgrowth-mcp est sûr ?

Au dernier audit MCP Hub, le serveur MCP « io.github.Z4KARY/upgrowth-mcp » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.

Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.

Les 30 outils

• calculate_casnos≈ 2345 tokens

  Estimate the yearly contribution to CASNOS, the Algerian social security fund of the self-employed, for 2026, with the same formula as the UpGrowth calculator: a rate applied to a base that depends on the tax regime, between a floor and a ceiling indexed on the minimum wage (SNMG). Rule applied for Algeria: article 14 of executive decree 15-289 as rewritten by executive decree 26-257 of 15 July 2026 (JO 2026 no. 53, published 23 July 2026, no entry-into-force clause): rate 15 % (7.5 % social insurance, 7.5 % pension) on a base floored at the yearly SNMG (24,000 DA a month, so 288,000 DA, a minimum contribution of 43,200 DA) and capped at twenty times it (5,760,000 DA, a maximum contribution of 864,000 DA); flat-rate tax regimes take 25 % (production and sale of goods) or 35 % (services) of the previous year's tax turnover (decree 24-49), the actual profit regime takes the ordinary result before tax; the first year is based on the yearly SNMG; the auto-entrepreneur may choose 24,000 DA a year. Before 26-257 the floor was the yearly reference wage of 216,000 DA (decrees 22-121 and 20-240, a minimum contribution of 32,400 DA), and the 2026 contribution, due on 1 January, was payable before 1 July 2026: the texts do not say whether 26-257 applies to a 2026 contribution already due (À VÉRIFIER). Since 26-257, with several activities the contribution of each activity cannot be below the minimum; this tool handles one activity at a time. From the third year of activity a floor equal to the average contribution of the same activity in the same wilaya applies: its orders were not found in the Journal officiel, so it is not estimated. Give the regime and, for most regimes, the amount. Returns the yearly, monthly and quarterly contribution with the figures it was computed from, and its limitations: read data.limitations before quoting the result. It is an estimate from public texts, not tax or legal advice. For Tunisia (country TN) it gives the CNSS contribution of the self-employed workers of the non-agricultural sector: regime INDEPENDANT_NON_AGRICOLE and income_class (1 to 10), the quarterly amount the CNSS prints for that class (rate 14.71 %), the yearly amount (four quarters) and the monthly equivalent, in Tunisian dinars, with the period the scale is valid for and the full scale of ten classes; the revenue is not used. Other Tunisian self-employed schemes (agricultural, fishing, craftsmen) are regimes of the same tool, and the Tunisian flat tax is calculate_ifu. Tunisia needs an API key. Morocco (country MA): regime AUTO_ENTREPRENEUR returns the bracket, the quarterly and yearly AMO contribution (supplementary rights, decree 2-21-928) and the pension contribution at 1.57 times it, with the payment dates; regime TRAVAILLEUR_NON_SALARIE returns, for a category (doctor, notary, driver, farmer...), the forfait income multiple set by its decree with its Bulletin officiel, and the rates (AMO 6.37 percent, pension 10 percent of the forfait income, decrees 2-18-623 and 2-18-625); with minimum_wage_hourly it also gives the forfait income and the contributions in dirhams.

  Paramètres, retour & exemple (14)

  Paramètres

  • lang · string · optionnel · fr | ar | en
    Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English).
  • tier · string · optionnel
    Morocco only (country MA): the tier of the category when it has several (for example general or specialist for a doctor, owner or non_owner for a driver, class_1 to class_9 for a farmer, simplified for a trader under the simplified net result regime). The answer lists the tiers of the category.
  • year · integer · optionnel
    Year of the rates. Only the 2026 rates are published today, so this can be left out.
  • regime · string · requis · FORFAITAIRE_ACHAT_VENTE | FORFAITAIRE_PRESTATIONS | BENEFICE_REEL | AUTO_ENTREPRENEUR | PREMIERE_ANNEE | INDEPENDANT_NON_AGRICOLE | INDEPENDANT_AGRICOLE | ARMATEUR_PECHE_30T
    Algeria: FORFAITAIRE_ACHAT_VENTE (flat-rate, goods, 25 %), FORFAITAIRE_PRESTATIONS (flat-rate, services, 35 %), BENEFICE_REEL (actual profit), AUTO_ENTREPRENEUR (24,000 DA option) or PREMIERE_ANNEE (first year). Tunisia (country TN): INDEPENDANT_NON_AGRICOLE, INDEPENDANT_AGRICOLE and ARMATEUR_PECHE_30T (ten classes, need income_class); PETIT_AGRICULTEUR, PETIT_ARMATEUR_PECHE and PECHEUR_INDEPENDANT (flat 7.5 % scheme of law 2002-32); ARTISAN (craftsmen of the same law, 7.5 % of 2/3 of the SMIG over 200 hours a month). Morocco (country MA): AUTO_ENTREPRENEUR (decree 2-21-928) or TRAVAILLEUR_NON_SALARIE (the other non-salaried workers: one decree per category, chosen with category).
  • country · string · optionnel
    Country of the data, an ISO 3166-1 alpha-2 code in any letter case: DZ for Algeria, the default, TN for Tunisia or MA for Morocco. Only live countries answer: list_countries shows them and their datasets. Any other country, or a dataset the country does not have (for example the activity nomenclature for Morocco), returns country_not_available. Without an API key only DZ answers: TN and MA return key_required.
  • revenue · number · optionnel
    Yearly amount in Algerian dinars (DZD). For the flat-rate regimes send the tax turnover (chiffre d'affaires fiscal) of the previous financial year; for BENEFICE_REEL send the ordinary result before tax (résultat ordinaire avant impôt) of the financial year closed and declared the previous year. Needed for those three regimes, ignored for AUTO_ENTREPRENEUR and PREMIERE_ANNEE. Ignored for Tunisia (country TN), whose contribution depends on the income class. For Morocco (country MA, regime AUTO_ENTREPRENEUR) it is required: the yearly amount, in Moroccan dirhams (MAD), of the "droits annuels" that select the bracket of the scale of the tax administration.
  • category · string · optionnel
    Morocco only (country MA), regime TRAVAILLEUR_NON_SALARIE: the category of non-salaried worker, for example doctor, dentist, pharmacist, notary, architect, veterinarian, land_surveyor, judicial_bailiff, taxi_driver, professional_driver, farmer, trader_artisan_accounting, artisan_unaccounted, traditional_fishing_boat_owner, cpu. Leave it out to list the categories, each with its decree and its Bulletin officiel.
  • net_profit · number · optionnel
    Morocco only (country MA), category trader_artisan_accounting under the actual net result regime: the annual net profit in dirhams, which picks the tier (up to 100,000 dirhams or above).
  • week_hours · integer · optionnel · 40 | 48
    Tunisia only (country TN): the weekly working-time regime whose SMIG of décret 2026-67 the craftsmen's contribution uses when smig_monthly_tnd is left out: 48 (554.736 dinars a month, the default) or 40 (470.251). The CNSS page of the craftsmen uses the 48 hour regime, so leave it at 48.
  • annual_hours · integer · optionnel
    Morocco only (country MA): the normal yearly working time in hours used with minimum_wage_hourly; 2,288 (article 184 of the Labour Code, not read in the decrees) when left out.
  • income_class · integer · optionnel
    Tunisia only (country TN): the income class of the insured person in the CNSS scale of the self-employed, from 1 (the lowest base) to 10. Required with the regime INDEPENDANT_NON_AGRICOLE; the answer lists the ten classes. Ignored for Algeria.
  • seniority_years · number · optionnel
    Morocco only (country MA): the seniority in years, which picks the tier of the categories whose forfait income depends on it (dentist, veterinarian, land_surveyor, architect). Complete years count.
  • smig_monthly_tnd · number · optionnel
    Tunisia only (country TN): the monthly guaranteed minimum wage (SMIG) in dinars, for the craftsmen of the law no. 2002-32 (regime ARTISAN of calculate_casnos, activity crafts of calculate_ifu): their contribution is 7.5 % of two thirds of its hourly value (monthly amount divided by 208 hours at 48 hours a week) over 200 hours a month. Leave it out to use the SMIG of décret 2026-67 (554.736 dinars, 48 hour week; see week_hours).
  • minimum_wage_hourly · number · optionnel
    Morocco only (country MA), regime TRAVAILLEUR_NON_SALARIE: the legal hourly minimum wage of non-agricultural activities in dirhams, which the decrees do not state. With it the answer gives the forfait income in dirhams (multiplier times that wage times the yearly hours) and the AMO and pension contributions on it.

  Exemple d'appel

  {"name": "calculate_casnos", "arguments": {"regime": "FORFAITAIRE_ACHAT_VENTE"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• calculate_ifu≈ 1661 tokens

  Estimate the IFU (Impôt Forfaitaire Unique), the flat tax of Algerian micro-businesses, for 2026, with the same formula as the UpGrowth calculator: a rate on the yearly turnover that depends on the regime (auto-entrepreneur or general) and, for the general regime, on the kind of activity, with a minimum tax. Returns the inputs, the base, the rate, whether the minimum applied and the result, and its limitations: read data.limitations before quoting the result. It is an estimate from public texts, not tax or legal advice. For Algeria it does not test eligibility: the IFU is open only to natural persons, traditional art and craft cooperatives and professional civil partnerships (never a SARL or an EURL), up to 8,000,000 DA of turnover (5,000,000 DA for the auto-entrepreneur status), and CIDTA art. 282 ter excludes nineteen activities (real estate promotion, import and wholesale resale, dealers, clinics and laboratories, classified restaurants and hotels, precious metals, public works and building, alcohol outlets, leaf tobacco, caterers, event halls, large stores, vehicle and equipment rental, travel agencies, advertising and communication agencies, training and teaching, insurance agents and brokers). For Tunisia (country TN, regime ae) it estimates the single contribution of the auto-entrepreneur, a yearly amount that does not depend on the turnover (which is only compared with the ceiling of 75,000 dinars): 200 dinars of income tax in a communal zone or 100 dinars elsewhere (zone), plus the social part of the first bracket of the CNSS scale; activity is required and, for a craft activity of the order of 23 July 2002 (crafts), the social part is 7.5 % of two thirds of the hourly SMIG over 200 hours a month (SMIG of décret 2026-67, or smig_monthly_tnd). Tunisia also serves regime forfait (option, zone, rural) and regime general (net_income: the income tax scale). Tunisia needs an API key. For Morocco (country MA) it computes the tax of the auto-entrepreneur on the turnover collected (regime ae only, activity required: 0.5 % for production and commerce up to 500 000 dirhams, 1 % for services up to 200 000 dirhams), with amounts in dirhams (tax_mad); the contribution professionnelle unique is not covered. Morocco needs an API key.

  Paramètres, retour & exemple (11)

  Paramètres

  • lang · string · optionnel · fr | ar | en
    Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English).
  • zone · string · optionnel · communal | other
    Tunisia only (country TN), required: communal for a person working in a communal zone, within the limits of the communes before 1 January 2015 (200 dinars of income tax a year), other for any other zone (100 dinars). Ignored for Algeria.
  • rural · boolean · optionnel
    Tunisia only (country TN), regime forfait with option optional: true for a person working in the rural zones and the villages, who pays half the amount.
  • option · string · optionnel · standard | optional
    Tunisia only (country TN), regime forfait: standard for the tariff of article 44 ter (400 dinars in a communal zone, 200 elsewhere, up to 10,000 dinars of turnover, then 3 %) or optional for the optional forfait tax of paragraph 1 (4,000 dinars up to 50,000 of turnover, 5,000 dinars up to 100,000).
  • regime · string · requis · ae | general | forfait
    ae for the auto-entrepreneur status (ANAE), general for the general IFU regime of the other micro-businesses. Tunisia (country TN): ae (single contribution), forfait (forfait tax of article 44 ter of the income tax code, with option and zone) or general (the income tax scale of article 44 applied to net_income).
  • country · string · optionnel
    Country of the data, an ISO 3166-1 alpha-2 code in any letter case: DZ for Algeria, the default, TN for Tunisia or MA for Morocco. Only live countries answer: list_countries shows them and their datasets. Any other country, or a dataset the country does not have (for example the activity nomenclature for Morocco), returns country_not_available. Without an API key only DZ answers: TN and MA return key_required.
  • activity · string · optionnel · production | commerce | services | crafts
    Kind of activity: production (goods), commerce (resale in the same state) or services (including liberal professions). Required with the general regime, where it sets the rate; ignored with ae. Tunisia (country TN): required, and crafts means a craft or artisanal activity of the order of 23 July 2002, whose social part is two thirds of the SMIG at 7.5 % (week_hours, smig_monthly_tnd). For Morocco (country MA) it is required with ae: production and commerce are taxed at 0.5 %, services at 1 %.
  • turnover · number · requis
    Yearly turnover (chiffre d'affaires) in Algerian dinars (DZD), or in Moroccan dirhams (MAD) for country MA.
  • net_income · number · optionnel
    Tunisia only (country TN), required with regime general: the net taxable income in Tunisian dinars, after the deductions of the code. The scale of article 44 of the income tax code is applied to it; the turnover only serves the minimum tax.
  • week_hours · integer · optionnel · 40 | 48
    Tunisia only (country TN): the weekly working-time regime whose SMIG of décret 2026-67 the craftsmen's contribution uses when smig_monthly_tnd is left out: 48 (554.736 dinars a month, the default) or 40 (470.251). The CNSS page of the craftsmen uses the 48 hour regime, so leave it at 48.
  • smig_monthly_tnd · number · optionnel
    Tunisia only (country TN): the monthly guaranteed minimum wage (SMIG) in dinars, for the craftsmen of the law no. 2002-32 (regime ARTISAN of calculate_casnos, activity crafts of calculate_ifu): their contribution is 7.5 % of two thirds of its hourly value (monthly amount divided by 208 hours at 48 hours a week) over 200 hours a month. Leave it out to use the SMIG of décret 2026-67 (554.736 dinars, 48 hour week; see week_hours).

  Exemple d'appel

  {"name": "calculate_ifu", "arguments": {"regime": "ae", "turnover": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• creation_legal_forms≈ 694 tokens

  List the main legal forms to create a company in Algeria: SARL, EURL, SPA, SPAS and SPASU (the simplified joint-stock company of loi 22-09, reserved to companies certified start-up), SNC, sole trader and auto-entrepreneur. Other forms of the commercial code (sociétés en commandite, groupement, société en participation) are not in this list, so never say a form does not exist because it is missing here: check search_jo_text. For each form it gives the number of partners allowed, the minimum capital and the official State fees of each creation step (trade register, legal announcements and so on) for 2026, with the total of the published fees. A step whose price no official text fixes, such as the notary or the bank, is flagged as not priced instead of guessed. It lists State fees only, never the fees of a service provider, so it is not a quote for a creation. For Tunisia (country TN) it lists the legal forms of the commercial companies code (SARL, SUARL, SA, SNC, SCS) and the sole trader, with the partners allowed, the minimum capital, the liability and the registration steps at the National Register of Enterprises, each with its official fee in Tunisian dinars, its documents and its delay. For Morocco (country MA) it lists the SARL, the single-member SARL (SARL AU), the SA, the SAS, the SNC and the SCS, the sole trader and the auto-entrepreneur status, with the partners allowed, the minimum capital, the liability and the creation steps (negative certificate of OMPIC, statutes, registration of the deeds, professional tax and tax identification, trade register, CNSS affiliation, publication in the official gazette), each with its official fee in Moroccan dirhams when an official page states one. Tunisia and Morocco need an API key.

  Paramètres, retour & exemple (2)

  Paramètres

  • lang · string · optionnel · fr | ar | en
    Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English).
  • country · string · optionnel
    Country of the data, an ISO 3166-1 alpha-2 code in any letter case: DZ for Algeria, the default, TN for Tunisia or MA for Morocco. Only live countries answer: list_countries shows them and their datasets. Any other country, or a dataset the country does not have (for example the activity nomenclature for Morocco), returns country_not_available. Without an API key only DZ answers: TN and MA return key_required.

  Exemple d'appel

  {"name": "creation_legal_forms", "arguments": {"lang": "fr", "country": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• customs_tariff_chapters≈ 422 tokens

  List the chapters (two-digit codes) of one section of the Algerian customs tariff with their titles, for example the chapters of section XVI. Use it after customs_tariff_sections. The same for the Tunisian tariff with country TN (French titles; needs an API key) and for Morocco with country MA (harmonized system 2022, French titles; needs an API key). This dataset holds no duty rates and no tariff lines below the chapter level.

  Paramètres, retour & exemple (3)

  Paramètres

  • lang · string · optionnel · fr | ar | en
    Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English).
  • country · string · optionnel
    Country of the data, an ISO 3166-1 alpha-2 code in any letter case: DZ for Algeria, the default, TN for Tunisia or MA for Morocco. Only live countries answer: list_countries shows them and their datasets. Any other country, or a dataset the country does not have (for example the activity nomenclature for Morocco), returns country_not_available. Without an API key only DZ answers: TN and MA return key_required.
  • section · string · requis
    Section of the customs tariff in capital Roman numerals, for example XVI. Find the sections with customs_tariff_sections.

  Exemple d'appel

  {"name": "customs_tariff_chapters", "arguments": {"section": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• customs_tariff_sections≈ 476 tokens

  List the sections of the Algerian customs tariff, the first level of the harmonized system classification of goods, each with its Roman numeral, its title and the range of its chapters. For Algeria the tariff is not printed in the Journal officiel (ordonnance 01-02 has it published apart by the finance ministry): meta.sources cites the acts behind it and meta.status_note marks the titles À VÉRIFIER. Use it to locate a family of products before listing the chapters of a section. For Tunisia (country TN) it lists the sections of the Tunisian customs tariff, with the titles in French read on the site of the General Directorate of Customs (douane.gov.tn); Tunisia needs an API key. For Morocco (country MA) it lists the 21 sections of the harmonized system 2022 in French (the ADII tariff adopts it; MA needs an API key). This dataset holds no duty rates and no tariff lines below the chapter level.

  Paramètres, retour & exemple (2)

  Paramètres

  • lang · string · optionnel · fr | ar | en
    Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English).
  • country · string · optionnel
    Country of the data, an ISO 3166-1 alpha-2 code in any letter case: DZ for Algeria, the default, TN for Tunisia or MA for Morocco. Only live countries answer: list_countries shows them and their datasets. Any other country, or a dataset the country does not have (for example the activity nomenclature for Morocco), returns country_not_available. Without an API key only DZ answers: TN and MA return key_required.

  Exemple d'appel

  {"name": "customs_tariff_sections", "arguments": {"lang": "fr", "country": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_activity_code≈ 764 tokens

  Get one activity of the Algerian CNRC nomenclature by its six-digit code, for example 101101: its status (free, regulated or blocked), its labels in French, Arabic and English, its sector and group, the URL of its page on upgrowth.dz and, in French, the text of the code as the CNRC publishes it: the supervising authority, the type of authorization, what the activity covers, its accessory activities and its legal references. Where UpGrowth compared the text with the Journal officiel and found an abrogated or mistyped reference, a wrong authority or type, or a doubt, details.jo_check gives the corrected value (already put in the field), the value it replaced, the act, the Journal officiel issue and the article, or what is left to verify: read it before quoting the authority or the text of a code. Use it when the user already gives a code, or after search_activity_codes. Returns an error when the code does not exist. For Tunisia (country TN) pass the four-digit NAT 2009 class code, for example 0111: you get its label in French, its section, division and group, its status (reglementee with the authorisations of annex 1 of décret 2018-417 that govern it and their legal references, or libre because that list is exclusive) and the official source. Pass A1-017 or A2-005 to get one authorisation of the decree as a record. For Morocco (country MA) pass the four-digit NMA 2010 code, for example 0111: you get its labels, section, branch, sub-branch and its status not_determined.

  Paramètres, retour & exemple (3)

  Paramètres

  • code · string · requis
    Activity code. Algeria: the CNRC code, six digits, for example 101101. Tunisia (country TN): the NAT 2009 class code, four digits, for example 0111 or 01.11, or the code of an authorisation of décret 2018-417, A1-017 (annex 1) or A2-005 (annex 2), or one added by décret 2022-317 such as A1-019bis. Morocco (country MA): the NMA 2010 activity code, four digits, for example 0111. Find codes with search_activity_codes.
  • lang · string · optionnel · fr | ar | en
    Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English).
  • country · string · optionnel
    Country of the data, an ISO 3166-1 alpha-2 code in any letter case: DZ for Algeria, the default, TN for Tunisia or MA for Morocco. Only live countries answer: list_countries shows them and their datasets. Any other country, or a dataset the country does not have (for example the activity nomenclature for Morocco), returns country_not_available. Without an API key only DZ answers: TN and MA return key_required.

  Exemple d'appel

  {"name": "get_activity_code", "arguments": {"code": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_anae_activity≈ 910 tokens

  Get one activity of the Algerian ANAE nomenclature (auto-entrepreneur status) by its six-digit code, for example 010101: its labels in French, Arabic and English and its domain. Use it when the user gives a code, or after search_anae_activities. Returns an error when the code does not exist. In Algeria an activity that has a regime of its own carries the optional object regime, present only then and today only for 080101, micro-importation: note (the facts in French, Arabic and English: who may import, at most 1,800,000 DZD of goods per trip and two trips a month, the card and the general authorisation of the Ministry of Foreign Trade, the conditions, the advantages, the obligations, the exclusions), legal_reference (executive decree n° 25-170 of 28 June 2025, JO n° 40 of 2025, and the finance law for 2026, law no. 25-17, JO n° 88 of 2025, art. 143, which sets the 5 % customs duty, the exemptions and the flat single tax of 0.5 % per import) and source_url (the Journal Officiel PDF of the decree). That activity is NOT governed by the ordinary auto-entrepreneur limits (finance law 2026, art. 143: micro-importers are eligible notwithstanding the legislation in force, and no text read sets a yearly ceiling of its own for them): never present the 5 million DZD yearly turnover ceiling of the ordinary status as its limit, and read regime.note before answering about it. For Tunisia (country TN) pass the key regime: you get who qualifies (Tunisian nationality, individual practice, the sectors, the ceiling of 75,000 dinars of yearly turnover), the exclusions, the duration, the registration, the single contribution with what it replaces and what it is made of, the late payment fine and the deregistration, each with the article of the law it comes from. The official list of activities is not loaded: say so, and never present the absence of an activity as an exclusion. For Morocco (country MA) pass the key of an excluded profession (for example avocats) to get it with the regime, or the key regime to get the regime alone: the definition, the turnover ceilings (500 000 and 200 000 dirhams), the tax rates (0.5 % and 1 %), the obligations and the legal texts (law 114-13 and its decrees).

  Paramètres, retour & exemple (3)

  Paramètres

  • code · string · requis
    ANAE activity code, six digits, for example 010101. For Morocco (country MA) it is the key of an excluded profession, for example avocats, or regime. Find codes with search_anae_activities. For Tunisia (country TN) it is the key of the regime record: regime (statut and ae are accepted too); Tunisia has no activity codes.
  • lang · string · optionnel · fr | ar | en
    Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English).
  • country · string · optionnel
    Country of the data, an ISO 3166-1 alpha-2 code in any letter case: DZ for Algeria, the default, TN for Tunisia or MA for Morocco. Only live countries answer: list_countries shows them and their datasets. Any other country, or a dataset the country does not have (for example the activity nomenclature for Morocco), returns country_not_available. Without an API key only DZ answers: TN and MA return key_required.

  Exemple d'appel

  {"name": "get_anae_activity", "arguments": {"code": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_commune≈ 393 tokens

  Get one commune of Algeria by its four-digit code (from list_communes) with everything Algérie Poste publishes about it: its names, wilaya and 2026 wilaya, its postal codes, and every post office (name in French and Arabic, class, address, postal code and former postal code, GPS position) and ATM (name, whether it works, postal code, GPS position). Data read from Algérie Poste every day. Algeria only.

  Paramètres, retour & exemple (3)

  Paramètres

  • code · string · requis
    The four-digit commune code, for example 1601 (Alger Centre).
  • lang · string · optionnel · fr | ar | en
    Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English).
  • country · string · optionnel
    Country of the data, an ISO 3166-1 alpha-2 code in any letter case: DZ for Algeria, the default, TN for Tunisia or MA for Morocco. Only live countries answer: list_countries shows them and their datasets. Any other country, or a dataset the country does not have (for example the activity nomenclature for Morocco), returns country_not_available. Without an API key only DZ answers: TN and MA return key_required.

  Exemple d'appel

  {"name": "get_commune", "arguments": {"code": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_jo_act≈ 783 tokens

  Get the full text of one act of the Algerian Journal Officiel published since 1962, by its number (for example 22-299, with type when a law and a decree share the number) or by year, issue and ord as search_jo_text returns them. Returns its type, number, title, first page, the links to the issue page and the official PDF, the text itself in parts of 20,000 characters (part, parts, chars: ask the next part to read on), and named_in_titles: the earlier or later acts whose title names this one, such as the decrees amending or completing it, its corrigenda and its implementing texts. Check named_in_titles before quoting an article: the text is the one published in that issue, not a consolidated version. For 1962 to 2001 (source scan) the text was read from the scan: a passage between [[? and ?]] is not settled yet (uncertain counts them), check it on pdf_url before quoting it; the page is the page of the scan. Without an API key, only the acts of the current year and the two before it. Algeria only (country DZ); other countries return country_not_available.

  Paramètres, retour & exemple (8)

  Paramètres

  • ord · integer · optionnel
    The place of the act in its issue, as search_jo_text returns it.
  • lang · string · optionnel · fr | ar | en
    Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English).
  • part · integer · optionnel
    Which part of the text, 1 by default; parts says how many there are.
  • type · string · optionnel · law | ordinance | presidential_decree | executive_decree | decree | order | interministerial_order | decision
    The kind of act, needed when several acts carry the number (a law and a decree, for example).
  • year · integer · optionnel
    The year of the issue (with issue and ord), or to narrow a number.
  • issue · integer · optionnel
    The number of the issue within its year, as search_jo_text returns it.
  • number · string · optionnel
    The number of the act as the Journal Officiel prints it, for example 22-299 or 26-06.
  • country · string · optionnel
    Country of the data, an ISO 3166-1 alpha-2 code in any letter case: DZ for Algeria, the default, TN for Tunisia or MA for Morocco. Only live countries answer: list_countries shows them and their datasets. Any other country, or a dataset the country does not have (for example the activity nomenclature for Morocco), returns country_not_available. Without an API key only DZ answers: TN and MA return key_required.

  Exemple d'appel

  {"name": "get_jo_act", "arguments": {"ord": 1, "lang": "fr", "part": 1, "type": "law", "year": 1, "issue": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_jo_issue≈ 766 tokens

  Get one issue of the Algerian Journal Officiel by year and number: the links to its official editions and, when UpGrowth holds it, its summary (sommaire): the date and, section by section, the official titles of the texts published in the issue. The summary exists only for some years and issues; otherwise data.sommaire is null and data.note says why. For 1962 to 2001 the summary is read from the scanned issue: data.sommaire.source says so, data.sommaire.titles_held_back counts the entries the readings did not agree on (not listed) and data.sommaire.complete is true when none is missing. For Morocco (country MA) pass the number of the Bulletin officiel, a continuous series (for example 7522): you get its publication date, the links to its French and Arabic editions and, in data.supplements, the supplements of that number (bis, ter); data.sommaire is always null, no Moroccan summary is held yet. For Tunisia (country TN) pass the number of the issue within the year (for example 97): you get its publication date and whether its French and Arabic editions exist, with no direct PDF link; data.sommaire is always null. Use it to find which texts an issue published. Without an API key only Algeria answers, for the current year and the two before it (older years return key_required).

  Paramètres, retour & exemple (4)

  Paramètres

  • lang · string · optionnel · fr | ar | en
    Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English).
  • year · integer · requis
    Year of the gazette: the Journal Officiel from 1962 for Algeria, the Bulletin officiel from 1912 for Morocco (country MA), the Journal Officiel de la République Tunisienne from 1956 for Tunisia (country TN). Find the years covered with list_jo_years. Without an API key only Algeria answers, for the current year and the two before it.
  • number · integer · requis
    Number of the issue. Algeria: its number within the year, starting at 1. Morocco: the number of the Bulletin officiel, a continuous series, for example 7522. Tunisia: its number within the year, for example 97. Find the numbers with list_jo_issues.
  • country · string · optionnel
    Country of the data, an ISO 3166-1 alpha-2 code in any letter case: DZ for Algeria, the default, TN for Tunisia or MA for Morocco. Only live countries answer: list_countries shows them and their datasets. Any other country, or a dataset the country does not have (for example the activity nomenclature for Morocco), returns country_not_available. Without an API key only DZ answers: TN and MA return key_required.

  Exemple d'appel

  {"name": "get_jo_issue", "arguments": {"year": 1, "number": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_social_contributions≈ 670 tokens

  Get the social contributions and payroll levies in a country in 2026, each with its base, its legal source and the official page it was read on. Algeria (DZ, the default country): the CNAS social security contribution on salaries (34.5 %: 25 % employer, 9 % employee and 0.5 % social works fund, with its split by branch; unemployment insurance and early retirement are branches inside that rate, not separate contributions), five special categories of workers (home workers, people employed by private individuals, artists and authors, parking attendants, fishing crews), and the CASNOS contribution of the self-employed with its rate, its base, its floor and ceiling (rule of executive decree 26-257, published 23 July 2026) and the auto-entrepreneur flat option. The Algerian list is not complete: the other categories of decree 85-34, journalists paid by the task, professional sports clubs and the CACOBATPH are not in it (see the note of cnas_general_regime), so never say a contribution does not exist because it is missing here: search the Journal officiel. Tunisia (TN): the social security (CNSS) contribution with its employer and employee shares, the work accident range, the complementary pension regime and the payroll levies (vocational training tax TFP and housing fund contribution FOPROLOS). Morocco (MA): the CNSS contributions (family allowances, short-term and long-term social benefits with their salary ceiling), the compulsory health insurance (AMO) and the vocational training tax (TFP), with the employer and employee shares. For an Algerian estimate use calculate_casnos and calculate_ifu. Tunisia and Morocco need an API key.

  Paramètres, retour & exemple (2)

  Paramètres

  • lang · string · optionnel · fr | ar | en
    Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English).
  • country · string · optionnel
    Country of the data, an ISO 3166-1 alpha-2 code in any letter case: DZ for Algeria, the default, TN for Tunisia or MA for Morocco. Only live countries answer: list_countries shows them and their datasets. Any other country, or a dataset the country does not have (for example the activity nomenclature for Morocco), returns country_not_available. Without an API key only DZ answers: TN and MA return key_required.

  Exemple d'appel

  {"name": "get_social_contributions", "arguments": {"lang": "fr", "country": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_support_schemes≈ 934 tokens

  Get the business support schemes and investment rules of Algeria as the Journal officiel sets them, each item with who it applies to, its amount when the text gives one, its article and the official Journal officiel issue: investment law 22-18 and its 2022 decrees (the investment regimes and their advantages and durations, the zones of particular interest, the structuring investments, the guarantees including the transfer of capital and income, the non-eligible activities, and the processing fees of the Algerian investment promotion agency AAPI: 60,000 DA for the registration certificate of a project under 2 billion DA, 400,000 DA for a larger or a foreign one, decree 22-299 art. 23), the start-up, innovative project, incubator and scale-up labels (decree 20-254 as amended in 2021 and 2025) and the tax advantages of the start-up and incubator labels (finance law 2026 arts 100 and 101: 4 years plus 2 on renewal for a start-up, 2 years renewable for an incubator; decree 21-170 as amended in 2023 for the list of equipment), the NESDA scheme (conditions of article 2: project holders aged 18 to 55 with a diploma, a qualification or recognised know-how, own funds and no earlier aid; self-financed micro-enterprise; rent loan up to 500,000 DA) and the CNAC transitional articles abrogated with its statute (decree 26-258; the pending files and the scheme of decree 03-514 marked À VÉRIFIER). The investment law still names the professional activity tax, which the 2024 finance law abolished; its article 79 replaces such references, as the case may be, by the local solidarity tax, so the IBS exemption applies and the TAP part is marked À VÉRIFIER. The micro-credit (ANGEM) amounts and the NESDA and CNAC financing levels are left out on purpose (they were amended several times and the whole chain of texts is not read): do not quote figures for them. A point the published text leaves open is marked TO VERIFY (À VÉRIFIER) in the item. Filters: q (words, accents ignored, e.g. redevance, transfert, label) and treatment (investment_regime, investment_zone, investment_guarantee, investment_fees, non_eligible, label, startup_tax, nesda, cnac). Algeria only (country DZ); other countries return country_not_available.

  Paramètres, retour & exemple (4)

  Paramètres

  • q · string · optionnel
    Words that must all appear in the item (label, who, amount, legal basis), accents and case ignored, for example redevance, transfert, label, NESDA.
  • lang · string · optionnel · fr | ar | en
    Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English).
  • country · string · optionnel
    Country of the data, an ISO 3166-1 alpha-2 code in any letter case: DZ for Algeria, the default, TN for Tunisia or MA for Morocco. Only live countries answer: list_countries shows them and their datasets. Any other country, or a dataset the country does not have (for example the activity nomenclature for Morocco), returns country_not_available. Without an API key only DZ answers: TN and MA return key_required.
  • treatment · string · optionnel · investment_regime | investment_zone | investment_guarantee | investment_fees | non_eligible | label | startup_tax | nesda
    Only the items of this kind.

  Exemple d'appel

  {"name": "get_support_schemes", "arguments": {"q": "texte", "lang": "fr", "country": "texte", "treatment": "investment_regime"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_tax_calendar≈ 953 tokens

  Get the legal filing and payment deadlines of businesses in Algeria, each with who must file, the deadline as the text words it, its article and the official text it was read in (the 2026 tax codes of the Directorate General of Taxes, checked on 20 October 2026 against the finance laws of the Journal officiel, and the CNAS and CASNOS sites): the monthly VAT return and payment (G50, within the first 20 days of each month, CTCA art. 76-1, and every quarter under the simplified regime, art. 78 bis), the withholding tax on salaries, pensions and annuities (by the 20th, monthly or quarterly, CIDTA art. 129-1), the IBS advance payments (20 March, 20 June and 20 November, art. 356) and the IRG advance payments (art. 355), the IFU forecast return G12 and the IFU minimum (by 30 June), the IFU payment in full or in instalments (50 %, then 1-15 September and 1-15 December), the IFU final return G12 bis (by 20 January of the next year), the IFU option for the real regime (before 1 February) and the IFU late filing increases (10 %, 20 %, 25 %), the declaration of existence (within 30 days of the start of the activity), the annual profit return (by 30 April), the annual summary statement ERA (before 30 September), the annual IRG return (by 30 June), the special return of the IRG result (by 30 April), the transfer pricing return (by 30 April), the vocational training and apprenticeship taxes (every half year, by the 20th of the following month), the penalty for an annual return not filed (25 %, reduced to 10 % or 20 % when filed within two months, 35 % after a formal notice), the CNAS contributions (within 30 days of each quarter or month), the CNAS annual declaration DAS (within 30 days of the year end) and affiliation (within 10 days of hiring), and the CASNOS base declaration (by 1 March) and annual contribution (before 1 July, before 1 October for people carrying on an agricultural activity only). A deadline on a legal holiday moves to the next working day. The list is not exhaustive: other taxes and returns of the codes are not included, and the extensions of deadlines decided by the DGI (law 23-15, art. 14) are not listed. Filters: q (words, accents ignored, e.g. "IFU" or "CNAS") and treatment (monthly, quarterly, semiannual, annual, advance, ifu, social, penalty, general). Algeria only (country DZ); other countries return country_not_available.

  Paramètres, retour & exemple (4)

  Paramètres

  • q · string · optionnel
    Words that must all appear in the item (label, who, deadline, legal basis), accents and case ignored, for example G50, IFU, CNAS, 30 avril.
  • lang · string · optionnel · fr | ar | en
    Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English).
  • country · string · optionnel
    Country of the data, an ISO 3166-1 alpha-2 code in any letter case: DZ for Algeria, the default, TN for Tunisia or MA for Morocco. Only live countries answer: list_countries shows them and their datasets. Any other country, or a dataset the country does not have (for example the activity nomenclature for Morocco), returns country_not_available. Without an API key only DZ answers: TN and MA return key_required.
  • treatment · string · optionnel · monthly | quarterly | semiannual | annual | advance | ifu | social | penalty
    Only the obligations of this kind.

  Exemple d'appel

  {"name": "get_tax_calendar", "arguments": {"q": "texte", "lang": "fr", "country": "texte", "treatment": "monthly"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_tax_code_article≈ 656 tokens

  Get one article of one of the six tax codes of Algeria in full, from the 2026 editions of the Direction générale des impôts: cidta, cpf, ctca, ce, cii or ct (search_tax_code says what each holds), by the number the code prints: 150, 282 quater, 300-3, 2 bis (Art., accents and case are ignored). Returns the code and its title, the edition, the link to the official PDF, the article id, its heading (part, title, chapter, section), its status (in_force, or abrogated: such an article holds only the word Abrogé), its text in French with the paragraphs on separate lines, its notes (the finance laws that created, amended or repealed it, as the code lists them) and the ids of the previous and the next article. The text is the DGI's consolidated edition and the legal reference stays the Journal officiel: use get_jo_act to read a finance law that a note names. An unknown article is a not_found error that lists the nearest article numbers. Use it to read an article before quoting it, and name it by code and number (for example CTCA art. 21). Algeria only (country DZ); other countries return country_not_available.

  Paramètres, retour & exemple (4)

  Paramètres

  • code · string · requis · cidta | cpf | ctca | ce | cii | ct
    The code: cidta (direct taxes and similar taxes), cpf (tax procedures), ctca (turnover taxes, VAT), ce (registration), cii (indirect taxes) or ct (stamp duty).
  • lang · string · optionnel · fr | ar | en
    Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English).
  • article · string · requis
    The article number as the code prints it, for example 150, 282 quater, 300-3 or 2 bis (Art., accents and case are ignored).
  • country · string · optionnel
    Country of the data, an ISO 3166-1 alpha-2 code in any letter case: DZ for Algeria, the default, TN for Tunisia or MA for Morocco. Only live countries answer: list_countries shows them and their datasets. Any other country, or a dataset the country does not have (for example the activity nomenclature for Morocco), returns country_not_available. Without an API key only DZ answers: TN and MA return key_required.

  Exemple d'appel

  {"name": "get_tax_code_article", "arguments": {"code": "cidta", "article": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_tax_rates≈ 535 tokens

  Get the business tax rates in force in 2026 for a country: the corporate income tax (the standard rate where there is one, the particular rates by sector or activity and the minimum tax), the value added tax rates and the main withholding tax rates, plus, for Algeria, the IRG income tax scale of CIDTA art. 104 (personal_income_tax: the scale of individuals, which the monthly withholding on salaries also applies, with abatements) and the IFU flat tax of micro-businesses (flat_tax: 5 % and 12 % up to 8,000,000 DA, 0.5 % for the auto-entrepreneur; eligibility and the nineteen excluded activities are in the notes of the record and in calculate_ifu), and, for Morocco, the IR income tax scale (personal_income_tax) and the flat tax of the auto-entrepreneur (flat_tax), each with the legal article it comes from, the date it applies from when the text gives one and the official page it was read on. Algeria (DZ, the default country), Tunisia (TN) and Morocco (MA) have this dataset; for Tunisia, personal_income_tax and flat_tax are null. It is a reading of public texts, not tax advice. Tunisia and Morocco need an API key.

  Paramètres, retour & exemple (2)

  Paramètres

  • lang · string · optionnel · fr | ar | en
    Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English).
  • country · string · optionnel
    Country of the data, an ISO 3166-1 alpha-2 code in any letter case: DZ for Algeria, the default, TN for Tunisia or MA for Morocco. Only live countries answer: list_countries shows them and their datasets. Any other country, or a dataset the country does not have (for example the activity nomenclature for Morocco), returns country_not_available. Without an API key only DZ answers: TN and MA return key_required.

  Exemple d'appel

  {"name": "get_tax_rates", "arguments": {"lang": "fr", "country": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_vat_regimes≈ 907 tokens

  Get the VAT (TVA) regimes of Algeria in force in 2026, each item with its legal basis (article of the Code des taxes sur le chiffre d'affaires and the finance law that set it) and the official text it was read in: the standard rate of 19 % (CTCA art. 21); the reduced rate of 9 %, which applies ONLY to the items listed in CTCA article 23 (31 of the 36 points of the article are in force, points 7, 11, 18, 31 and 34 being abrogated; LF 2026 art. 53 rewrote points 5, 9, 19 and 21: rehabilitation of old housing, catering and lodging of patients, education, teaching and vocational training supplied by State-approved enterprises, bus passenger transport; also new housing, medical acts, rail transport, listed food products, electricity and gas for small consumption, taxis, drinking water for households, cinema tickets, recoverable waste, tilapia products; sugar left the list in 2022); the exemptions (CTCA art. 8, 9, 10, 11, 13 and 42: exports with the right to deduct, bread, flours, milk, medicines, insurance, bank loans for housing, animal feed, vehicles of war invalids, imports under suspensive regimes, purchases under franchise, labelled start-ups' equipment..., and the temporary finance-law exemptions running to 31 December 2026: dried legumes, rice, fresh produce, eggs and poultry, internet access and web hosting, electricity and gas infrastructure); what is outside the scope (IFU taxpayers and auto-entrepreneurs, CTCA art. 8-2); and the rules that no longer exist (no 0 % rate since the 2020 supplementary finance law; online sales left the 9 % list in LF 2022 and are taxed at 19 %). Use it before saying which VAT rate applies to an activity: an activity that is not in the 9 % list or the exemptions is taxed at 19 %, unless the business is under the IFU or the auto-entrepreneur status. Filters: q (words that must all appear, accents ignored, e.g. "formation"), treatment (standard_19, reduced_9, exempt, outside_scope, abrogated, regime, territoriality) and in_force (false also lists the abrogated rules). Algeria only (country DZ); other countries return country_not_available.

  Paramètres, retour & exemple (5)

  Paramètres

  • q · string · optionnel
    Words that must all appear in the item (label, legal basis), accents and case ignored, for example formation, export, logement, IFU.
  • lang · string · optionnel · fr | ar | en
    Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English).
  • country · string · optionnel
    Country of the data, an ISO 3166-1 alpha-2 code in any letter case: DZ for Algeria, the default, TN for Tunisia or MA for Morocco. Only live countries answer: list_countries shows them and their datasets. Any other country, or a dataset the country does not have (for example the activity nomenclature for Morocco), returns country_not_available. Without an API key only DZ answers: TN and MA return key_required.
  • in_force · boolean · optionnel
    false also lists the rules that were abrogated (by default only the rules in force).
  • treatment · string · optionnel · standard_19 | reduced_9 | exempt | outside_scope | abrogated | regime | territoriality
    Only the items of this treatment.

  Exemple d'appel

  {"name": "get_vat_regimes", "arguments": {"q": "texte", "lang": "fr", "country": "texte", "in_force": true, "treatment": "standard_19"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_wilaya≈ 544 tokens

  Get one Algerian wilaya by its two-digit code, for example 16 for Alger: its names, capital, region, population and the details of its local CNRC (trade register) and CASNOS (social security of the self-employed) offices. For Tunisia (country TN) pass the governorate code, for example 11 for Tunis: its ISO 3166-2 code, national statistics (INS) code, names in the three languages and chief town. For Morocco (country MA) pass the region code, for example 06 for Casablanca-Settat: its ISO 3166-2 code, names in the three languages and chief town. Returns an error when the code is unknown. Use list_wilayas to see the codes. Tunisia and Morocco need an API key.

  Paramètres, retour & exemple (3)

  Paramètres

  • code · string · requis
    Wilaya code, two digits, for example 16 for Alger or 31 for Oran. For Tunisia (country TN) it is the governorate code, two digits, the number of its ISO 3166-2 code, for example 11 for Tunis (TN-11); TN-11 is accepted too. For Morocco (country MA) it is the region code, two digits, the number of its ISO 3166-2 code, for example 06 for Casablanca-Settat (MA-06); MA-06 is accepted too. Find codes with list_wilayas.
  • lang · string · optionnel · fr | ar | en
    Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English).
  • country · string · optionnel
    Country of the data, an ISO 3166-1 alpha-2 code in any letter case: DZ for Algeria, the default, TN for Tunisia or MA for Morocco. Only live countries answer: list_countries shows them and their datasets. Any other country, or a dataset the country does not have (for example the activity nomenclature for Morocco), returns country_not_available. Without an API key only DZ answers: TN and MA return key_required.

  Exemple d'appel

  {"name": "get_wilaya", "arguments": {"code": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_communes≈ 792 tokens

  List the communes (baladiyas) of Algeria from Algérie Poste's official data, read every day: each with its four-digit commune code, its French and Arabic names, its wilaya (number and names), its wilaya under loi n° 26-06 of 2026 when it is one of the 108 communes of the 11 wilayas that law created (wilaya_2026: its number 59 to 69 and slug), its postal codes and how many post offices and ATMs it has, and its daïra (daira: name, kind, wilaya; décret exécutif n° 91-306 as amended, Algiers' circonscriptions administratives). Filter by daira, by wilaya (a number from 1 to 69, 59 to 69 being the wilayas of 2026, or their slug such as aflou, barika, bou-saada) and by q (a name in French or Arabic, accents ignored, or the start of a postal code). Use it to check that a commune exists, to find its postal codes, or to list the communes a delivery zone covers. Algérie Poste lists 1,540 communes (those with a post office); the law counts 1,541. Without an API key, at most 10 rows. Algeria only.

  Paramètres, retour & exemple (7)

  Paramètres

  • q · string · optionnel
    A commune name in French or Arabic (accents ignored), or the first digits of a postal code.
  • lang · string · optionnel · fr | ar | en
    Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English).
  • daira · string · optionnel
    Only the communes of this daïra (or Algiers circonscription administrative), by name, accents ignored.
  • limit · integer · optionnel
    Maximum number of results in the page, from 1 to 100. Defaults to 20. Without an API key at most 10 rows come back.
  • offset · integer · optionnel
    Number of results to skip, from 0 to 10000, to read the next pages. Defaults to 0. meta.total tells how many results match. Without an API key it must be 0: a search cannot be paged.
  • wilaya · string · optionnel
    A wilaya number from 1 to 69 (16 for Alger, 59 to 69 the wilayas of 2026), or the slug of a wilaya created in 2026 (aflou, barika, el-kantara, bir-el-ater, el-aricha, ksar-chellala, ain-ouessara, messaad, ksar-el-boukhari, bou-saada, el-abiodh-sidi-cheikh).
  • country · string · optionnel
    Country of the data, an ISO 3166-1 alpha-2 code in any letter case: DZ for Algeria, the default, TN for Tunisia or MA for Morocco. Only live countries answer: list_countries shows them and their datasets. Any other country, or a dataset the country does not have (for example the activity nomenclature for Morocco), returns country_not_available. Without an API key only DZ answers: TN and MA return key_required.

  Exemple d'appel

  {"name": "list_communes", "arguments": {"q": "texte", "lang": "fr", "daira": "texte", "limit": 1, "offset": 1, "wilaya": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_countries≈ 574 tokens

  List the countries this server has business data for: for each its ISO code, its names in French, Arabic and English, the languages and the currency, its status (live: the data is served, planned: announced and not served yet) and the datasets it has. Algeria (DZ) is live with twelve datasets, the nine of its first release and its tax rates, social contributions and institutions, and Tunisia (TN) and Morocco (MA) with five each (governorates or regions, company legal forms, tax rates, social contributions, institutions); Morocco (MA) also has the index of its official gazette, the Bulletin officiel (list_jo_years, list_jo_issues, get_jo_issue), and Tunisia (TN) the index of its own, the Journal Officiel de la République Tunisienne (JORT), through the same three tools. Tunisia (TN) also has the activity nomenclature NAT 2009 (search_activity_codes, get_activity_code), the sections and chapters of its customs tariff (customs_tariff_sections, customs_tariff_chapters) and the CNSS contribution of the self-employed (calculate_casnos), the regime of the auto-entrepreneur as the finance law 2023 states it (search_anae_activities, get_anae_activity with the key regime; the official list of activities is not loaded) and the single contribution of the auto-entrepreneur (calculate_ifu with regime ae). Morocco (MA) also has the NMA 2010 activity nomenclature (activities), the auto-entrepreneur regime with its excluded professions (anae) and the auto-entrepreneur tax calculator (ifu). Use it first to see which countries and datasets exist before asking another tool for a country, or after a call came back country_not_available. Every country carries free_access: true when it answers without an API key (today Algeria only), false when it needs one. It takes no country, only the optional lang.

  Paramètres, retour & exemple (1)

  Paramètres

  • lang · string · optionnel · fr | ar | en
    Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English).

  Exemple d'appel

  {"name": "list_countries", "arguments": {"lang": "fr"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_dairas≈ 616 tokens

  List the daïras of Algeria, each with its communes (four-digit Algérie Poste code and name), as décret exécutif n° 91-306 du 24 août 1991 fixant la liste des communes animées par chaque chef de daïra sets them, with its amendments of 1992, 2018, 2021, 2025 and 2026 applied, read in the Journal officiel (meta.sources lists every text with its issue and PDF). The wilaya of Algiers (16) is organised in 13 circonscriptions administratives (décret présidentiel n° 2000-45), given with kind circonscription administrative. 69 wilayas, 553 daïras, 1,541 communes; Larbaa (daïra of Bouzina, Batna) has no post office and so no code. Filter by wilaya (1 to 69) and q (a daïra or commune name, accents ignored). Without an API key, at most 10 rows. Algeria only.

  Paramètres, retour & exemple (6)

  Paramètres

  • q · string · optionnel
    A daïra or commune name, accents ignored.
  • lang · string · optionnel · fr | ar | en
    Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English).
  • limit · integer · optionnel
    Maximum number of results in the page, from 1 to 100. Defaults to 20. Without an API key at most 10 rows come back.
  • offset · integer · optionnel
    Number of results to skip, from 0 to 10000, to read the next pages. Defaults to 0. meta.total tells how many results match. Without an API key it must be 0: a search cannot be paged.
  • wilaya · string · optionnel
    A wilaya number from 1 to 69.
  • country · string · optionnel
    Country of the data, an ISO 3166-1 alpha-2 code in any letter case: DZ for Algeria, the default, TN for Tunisia or MA for Morocco. Only live countries answer: list_countries shows them and their datasets. Any other country, or a dataset the country does not have (for example the activity nomenclature for Morocco), returns country_not_available. Without an API key only DZ answers: TN and MA return key_required.

  Exemple d'appel

  {"name": "list_dairas", "arguments": {"q": "texte", "lang": "fr", "limit": 1, "offset": 1, "wilaya": "texte", "country": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_institutions≈ 568 tokens

  List the key public bodies a company deals with in a country, each with its official website, a one-line role and the official page it was read on. Use it to find which body handles a formality. Algeria (DZ, the default country): the trade register (CNRC), the investment promotion agency (AAPI), the tax administration (DGI), social security (CNAS for employees, CASNOS for the self-employed), customs, the statistics office (ONS), the Bank of Algeria and the auto-entrepreneur agency (ANAE); each Algerian role names the act that sets the body up when its Journal officiel text was read (decree 92-68 for the CNRC, decree 22-298 for the AAPI, decree 26-258 for the CNAS and the CASNOS, decree 23-196 for the ANAE, law 23-09 for the Bank of Algeria) and marks what no text confirmed as TO VERIFY (À VÉRIFIER). Tunisia (TN): the business register, the investment authority, the industry agency, the tax administration, social security, customs, the statistics institute and the central bank. Morocco (MA): the regional investment centres (CRI), the company register office (OMPIC), the tax administration, social security, customs, the statistics office (HCP) and the central bank. The list is short and takes no filter. Tunisia and Morocco need an API key.

  Paramètres, retour & exemple (2)

  Paramètres

  • lang · string · optionnel · fr | ar | en
    Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English).
  • country · string · optionnel
    Country of the data, an ISO 3166-1 alpha-2 code in any letter case: DZ for Algeria, the default, TN for Tunisia or MA for Morocco. Only live countries answer: list_countries shows them and their datasets. Any other country, or a dataset the country does not have (for example the activity nomenclature for Morocco), returns country_not_available. Without an API key only DZ answers: TN and MA return key_required.

  Exemple d'appel

  {"name": "list_institutions", "arguments": {"lang": "fr", "country": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_jo_issues≈ 662 tokens

  List the issues of the Algerian Journal Officiel for one year: for each issue its number, whether the French and Arabic editions exist with the links to their official PDF files on joradp.dz, and whether UpGrowth holds its summary. For Morocco (country MA) it lists the issues of the Bulletin officiel for one year, from 1912: for each issue its number, its publication date and the links to its French and Arabic editions on sgg.gov.ma (editions.fr and editions.ar, each with available true or false and pdf_url); a supplement (bis, ter) is listed beside its issue, with its suffix. For Tunisia (country TN) it lists the issues of the JORT for one year, from 1956: for each issue its number within the year, its publication date and whether its French and Arabic editions exist; the official site gives no direct link to the PDF files, so pdf_url is null. Returns an error when no issue is indexed for the year. Use it to find the number of an issue, then get_jo_issue to see what the issue contains. Without an API key only Algeria answers, for the current year and the two before it (older years return key_required), and at most 10 issues come back: meta.truncated says when more exist.

  Paramètres, retour & exemple (3)

  Paramètres

  • lang · string · optionnel · fr | ar | en
    Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English).
  • year · integer · requis
    Year of the gazette: the Journal Officiel from 1962 for Algeria, the Bulletin officiel from 1912 for Morocco (country MA), the Journal Officiel de la République Tunisienne from 1956 for Tunisia (country TN). Find the years covered with list_jo_years. Without an API key only Algeria answers, for the current year and the two before it.
  • country · string · optionnel
    Country of the data, an ISO 3166-1 alpha-2 code in any letter case: DZ for Algeria, the default, TN for Tunisia or MA for Morocco. Only live countries answer: list_countries shows them and their datasets. Any other country, or a dataset the country does not have (for example the activity nomenclature for Morocco), returns country_not_available. Without an API key only DZ answers: TN and MA return key_required.

  Exemple d'appel

  {"name": "list_jo_issues", "arguments": {"year": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_jo_years≈ 508 tokens

  List the years covered by the index of the Journal Officiel de la République Algérienne (JORA), the official gazette in which Algerian laws, ordinances, decrees and orders are published, from 1962, newest year first. For each year: its number of issues, the last issue number, how many issues have a French and an Arabic edition, and for how many issues UpGrowth holds a summary. For Morocco (country MA) it lists the years of the Bulletin officiel du Royaume du Maroc, the Moroccan official gazette, from 1912: its French and Arabic editions (the French translation edition holds fewer issues) and no summaries. For Tunisia (country TN) it lists the years of the Journal Officiel de la République Tunisienne (JORT), the Tunisian official gazette, from 1956: its French and Arabic editions and no summaries. Use it first, to see which years exist before listing the issues of a year. Without an API key only Algeria answers, and meta.free_years lists the years it may read: the other years need a key. Takes only the optional lang and country.

  Paramètres, retour & exemple (2)

  Paramètres

  • lang · string · optionnel · fr | ar | en
    Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English).
  • country · string · optionnel
    Country of the data, an ISO 3166-1 alpha-2 code in any letter case: DZ for Algeria, the default, TN for Tunisia or MA for Morocco. Only live countries answer: list_countries shows them and their datasets. Any other country, or a dataset the country does not have (for example the activity nomenclature for Morocco), returns country_not_available. Without an API key only DZ answers: TN and MA return key_required.

  Exemple d'appel

  {"name": "list_jo_years", "arguments": {"lang": "fr", "country": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_wilayas≈ 674 tokens

  List the wilayas (provinces) of Algeria: 69 since loi n° 26-06 of 4 April 2026 (Journal officiel n° 25): the 58 numbered ones, then the 11 created by that law (Aflou, Barika, El Kantara, Bir El Ater, El Aricha, Ksar Chellala, Aïn Ouessara, Messaad, Ksar El Boukhari, Bou Saada, El Abiodh Sidi Cheikh), numbered 59 to 69 by décret présidentiel n° 26-206 of 25 May 2026 (Journal officiel n° 40), which come with their mother wilaya, their communes and in_place_by (their mother wilaya runs them until 31 December 2026 at the latest). For each wilaya in the dataset, with their two-digit code, their names in the three languages, capital, region and population, the address and phone of the local CNRC (trade register) office and the address of the local CASNOS (social security of the self-employed) office. Codes, names and capitals come from décret 84-79 (01 to 48), décret présidentiel 21-117 (49 to 58) and décret présidentiel 26-206 (59 to 69), cited in meta.sources; population, region, office details and websites do not come from the Journal officiel (meta.fields_not_from_jo). Use it to turn a wilaya code into a name or the reverse, or to find the local offices for a company registration or a CASNOS affiliation. For Tunisia (country TN) it lists the 24 governorates instead: code, ISO 3166-2 code, national statistics (INS) code, names in the three languages, chief town and the official source, and the answer names every page it was read on. For Morocco (country MA) it lists the 12 regions of the 2015 division the same way: code, ISO 3166-2 code, names in the three languages, chief town and the official source. The list is short and takes no filter. Tunisia and Morocco need an API key.

  Paramètres, retour & exemple (2)

  Paramètres

  • lang · string · optionnel · fr | ar | en
    Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English).
  • country · string · optionnel
    Country of the data, an ISO 3166-1 alpha-2 code in any letter case: DZ for Algeria, the default, TN for Tunisia or MA for Morocco. Only live countries answer: list_countries shows them and their datasets. Any other country, or a dataset the country does not have (for example the activity nomenclature for Morocco), returns country_not_available. Without an API key only DZ answers: TN and MA return key_required.

  Exemple d'appel

  {"name": "list_wilayas", "arguments": {"lang": "fr", "country": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• search_activity_codes≈ 1598 tokens

  Search the official Algerian nomenclature of commercial activities kept by the CNRC (Centre National du Registre du Commerce): the six-digit codes written on a trade register entry. Use it to find the code of an activity described in French, Arabic or English, to read the CNRC status of an activity (libre, reglementee or bloquee: meta.status_note says what each means and what it does not prove) or to browse the activities of a sector. The status, the authority, the authorization and the references of a code are the CNRC's own, from its nomenclature of economic activities (NAE, executive decree 15-249 of 29 September 2015, content updated by order of the minister of commerce); that nomenclature is not a list of the activities that need a licence, and a libre code may still need a sector title. get_activity_code adds details.jo_check where UpGrowth found the Journal officiel contradicting or not settling the CNRC text. Returns a page of activities, each with its code, status, labels in the three languages, sector, group and the URL of its page on upgrowth.dz. meta.total is the number of matches. For Tunisia (country TN) it searches the official Tunisian nomenclature of activities, the NAT 2009 of the national statistics institute (INS): four-digit class codes (01.11 is written 0111), labels in French only, a section letter A to U as sector, each record citing its official source. The NAT is a statistical classification, not the list of activities that need an authorization: the status comes from a hand-reviewed map of its classes to the authorisations of annex 1 of décret 2018-417, the exclusive list (reglementee with the authorisations and their legal references, libre because the list is exclusive), never libre by default: without the map the status is not_determined. With list=authorisations it searches the authorisations themselves. Tunisia needs an API key. For Morocco (country MA) it searches the official NMA 2010 nomenclature of the Haut-Commissariat au Plan instead: four-digit codes, labels in French, the section letter A to U as sector, the branch and the sub-branch as group; the nomenclature is statistical and gives no authorization regime, so every Moroccan code has the status not_determined, never free. Morocco needs an API key. Without an API key at most 10 rows come back and meta.truncated says when more matched, so do not present such a list as complete. Every row carries its own status, but a truncated list can hide a regulated or blocked code: search again with status=reglementee or status=bloquee, or read get_activity_code, before calling an activity free.

  Paramètres, retour & exemple (8)

  Paramètres

  • q · string · optionnel
    Search text, at most 100 characters. Digits only, for example 5011: matches the activity codes that start with them. Words: every word must start a word of the activity label in French, Arabic or English, so a few specific words work best. Accents and letter case are ignored. Leave it out to browse with the other filters.
  • lang · string · optionnel · fr | ar | en
    Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English).
  • list · string · optionnel · nat | authorisations
    Tunisia only (country TN): nat (the default) searches the classes of the NAT 2009; authorisations searches the 100 authorisations of annex 1 (and the 27 of annex 2, those to be struck out) of décret gouvernemental n° 2018-417 of 11 May 2018, as records with their conditions, procedures, delays and legal references. Ignored for Algeria and Morocco. Get one with get_activity_code and a code such as A1-017.
  • limit · integer · optionnel
    Maximum number of results in the page, from 1 to 100. Defaults to 20. Without an API key at most 10 rows come back.
  • offset · integer · optionnel
    Number of results to skip, from 0 to 10000, to read the next pages. Defaults to 0. meta.total tells how many results match. Without an API key it must be 0: a search cannot be paged.
  • sector · string · optionnel · 1 | 2 | 3 | 4 | 5 | 6 | 7 | A
    Keep only activities of this sector. Algeria: the CNRC sector, given as its digit: 1 goods production, 2 artisanal production, 3 wholesale distribution, 4 import for resale, 5 retail distribution, 6 services, 7 export. Tunisia (country TN): the section letter of the NAT 2009, A to U, for example C for manufacturing. For Morocco (country MA): the section of the NMA 2010 as its letter, A to U (for example C for manufacturing, G for trade).
  • status · string · optionnel · libre | reglementee | bloquee | not_determined
    Keep only activities with this status: libre (the CNRC does not mark the code as regulated: not proof that no sector licence is needed), reglementee (regulated: the authorization or agrément that the text of the activity sets is required to exercise it) or bloquee (blocked: a status of the CNRC nomenclature, understood as not registrable under that code; no text of the Journal officiel read defines it and the data does not give the reason). For Tunisia (country TN): reglementee when an authorisation of annex 1 of décret 2018-417 governs the class, libre otherwise (the annex is the exclusive list), not_determined when that map is not loaded.
  • country · string · optionnel
    Country of the data, an ISO 3166-1 alpha-2 code in any letter case: DZ for Algeria, the default, TN for Tunisia or MA for Morocco. Only live countries answer: list_countries shows them and their datasets. Any other country, or a dataset the country does not have (for example the activity nomenclature for Morocco), returns country_not_available. Without an API key only DZ answers: TN and MA return key_required.

  Exemple d'appel

  {"name": "search_activity_codes", "arguments": {"q": "texte", "lang": "fr", "list": "nat", "limit": 1, "offset": 1, "sector": "1"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• search_anae_activities≈ 1022 tokens

  Search the list of activities open to the auto-entrepreneur status in Algeria, as the platform of the Agence Nationale de l'Auto-Entrepreneur (ANAE) publishes it, grouped in domains. The list is fixed by an order of the minister in charge of start-ups (executive decree 23-197, art. 8) whose list is attached to the original and not printed in the Journal officiel: this answer is not a Journal officiel text and may lag its latest update (meta.activity_list says so). Liberal professions, regulated professions and activities, and crafts are excluded from the list (law 22-23, art. 2). Use it to check whether an activity can be practised as an auto-entrepreneur and to find its six-digit code. Returns a page of activities with code, labels and domain. meta.total is the number of matches. In Algeria an activity that has a regime of its own, today 080101 (micro-importation), also carries the object regime: read it before answering about that activity, it is not the ordinary auto-entrepreneur regime (see get_anae_activity). For Morocco (country MA) the status is defined by exclusion: it returns the professions that decree 2-15-263 excludes from the auto-entrepreneur status (architects, lawyers, doctors, notaries and so on), each with key (an UpGrowth identifier, code is null: Morocco gives them no code), status excluded and its legal basis; it holds no list of eligible activities. Morocco needs an API key. Without an API key at most 10 rows come back and meta.truncated says when more matched, so do not present such a list as complete. For Tunisia (country TN) there is no list of activities: the one record is the regime of the auto-entrepreneur as the finance law 2023 states it (key regime), and meta.activity_list says that the official list of activities is not loaded, so an activity that is not in the answer is neither admitted nor excluded: never tell a user it is not eligible. Tunisia needs an API key.

  Paramètres, retour & exemple (6)

  Paramètres

  • q · string · optionnel
    Search text, at most 100 characters. Digits only: matches the ANAE codes that start with them. Words: every word must start a word of the activity label in French, Arabic or English. Accents and letter case are ignored. Leave it out to browse by domain.
  • lang · string · optionnel · fr | ar | en
    Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English).
  • limit · integer · optionnel
    Maximum number of results in the page, from 1 to 100. Defaults to 20. Without an API key at most 10 rows come back.
  • domain · string · optionnel
    Keep only activities of this ANAE domain, given by its six-digit domain code (it ends in 0000), for example 010000 for Advice, Expertise and Training. Every result carries its domain. Not used for Tunisia (country TN): it has one regime record and no domains.
  • offset · integer · optionnel
    Number of results to skip, from 0 to 10000, to read the next pages. Defaults to 0. meta.total tells how many results match. Without an API key it must be 0: a search cannot be paged.
  • country · string · optionnel
    Country of the data, an ISO 3166-1 alpha-2 code in any letter case: DZ for Algeria, the default, TN for Tunisia or MA for Morocco. Only live countries answer: list_countries shows them and their datasets. Any other country, or a dataset the country does not have (for example the activity nomenclature for Morocco), returns country_not_available. Without an API key only DZ answers: TN and MA return key_required.

  Exemple d'appel

  {"name": "search_anae_activities", "arguments": {"q": "texte", "lang": "fr", "limit": 1, "domain": "texte", "offset": 1, "country": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• search_jo_text≈ 903 tokens

  Search the full text of the acts published in the Algerian Journal Officiel since 1962 (French edition: laws, ordinances, presidential and executive decrees, orders, decisions, Bank of Algeria regulations, corrigenda), not only their titles. Each match gives the year, the issue, the place of the act in the issue (ord), its type, its number when it has one, its title, its first page, an excerpt around the words and the links to the issue page and the official PDF; get_jo_act then returns the whole text. Words are matched in French with accents and case ignored and plurals folded (for example "redevance dossiers investissement"); quotes search an exact phrase, OR offers alternatives and a leading minus excludes a word. Best matches first. Use it to find which text sets a rule, a rate, an amount or a procedure, then read that text with get_jo_act before quoting it. The text is the official one as published: an act amended since appears as it was printed. From 2002 the text is the one of the official PDF (source pdf); from 1962 to 2001 it was read from the scans by three independent machine readings, each word kept when two of them agree (source scan), and a passage no two readings gave alike is marked [[? ... ?]] (uncertain counts them in an act): check such a passage on the PDF before quoting it. Without an API key, only the current year and the two before it, and at most 10 matches (meta.free_years, meta.truncated). Algeria only (country DZ); other countries return country_not_available.

  Paramètres, retour & exemple (7)

  Paramètres

  • q · string · requis
    Words to find in the text, accents and case ignored, for example redevance traitement dossiers investissement, or a phrase in quotes.
  • lang · string · optionnel · fr | ar | en
    Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English).
  • type · string · optionnel · law | ordinance | presidential_decree | executive_decree | decree | order | interministerial_order | decision
    Only the acts of this kind.
  • year · integer · optionnel
    Only the acts published that year (2002 or later).
  • limit · integer · optionnel
    Maximum number of results in the page, from 1 to 100. Defaults to 20. Without an API key at most 10 rows come back.
  • offset · integer · optionnel
    Number of results to skip, from 0 to 10000, to read the next pages. Defaults to 0. meta.total tells how many results match. Without an API key it must be 0: a search cannot be paged.
  • country · string · optionnel
    Country of the data, an ISO 3166-1 alpha-2 code in any letter case: DZ for Algeria, the default, TN for Tunisia or MA for Morocco. Only live countries answer: list_countries shows them and their datasets. Any other country, or a dataset the country does not have (for example the activity nomenclature for Morocco), returns country_not_available. Without an API key only DZ answers: TN and MA return key_required.

  Exemple d'appel

  {"name": "search_jo_text", "arguments": {"q": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• search_jo_titles≈ 817 tokens

  Search the official titles of the texts listed in the summaries (sommaires) of the Algerian Journal Officiel: laws, ordinances, decrees, orders and notices. Each match gives the year and issue number, the section heading, the title and the links to the issue page and to its official PDF. Use it to find when and where a text was published. Only the issues whose summary UpGrowth holds are searched: every year from 1962 to today (without an API key, only the current year and the two before it, and at most 10 matches: meta.free_years and meta.truncated say so; meta.sommaire_years lists the years searched). The summaries of 1962 to 2001 are read from the scanned issues: a title is listed only when two of three independent readings give it word for word (the third, by Opus, settles what the first two dispute), 98 % of the entries, so an empty result does not prove that a text does not exist (search_jo_text searches their full text too), and those hits have no upgrowth.dz page (url is null, pdf_url links the official scan). Optionally restrict it to one year. Returns a page of matches; meta.total is their number. Algeria only: no Moroccan summaries are held yet, so country MA returns country_not_available, and so does country TN.

  Paramètres, retour & exemple (6)

  Paramètres

  • q · string · requis
    Words to look for in the official titles of the texts, for example loi de finances 2026. Every word must start a word of the title; accents and letter case are ignored. From 2 to 100 characters.
  • lang · string · optionnel · fr | ar | en
    Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English).
  • year · integer · optionnel
    Search only the issues of this year (1962 or later). Leave it out to search every year. Without an API key only the current year and the two before it can be searched.
  • limit · integer · optionnel
    Maximum number of results in the page, from 1 to 100. Defaults to 20. Without an API key at most 10 rows come back.
  • offset · integer · optionnel
    Number of results to skip, from 0 to 10000, to read the next pages. Defaults to 0. meta.total tells how many results match. Without an API key it must be 0: a search cannot be paged.
  • country · string · optionnel
    Country of the data, an ISO 3166-1 alpha-2 code in any letter case: DZ for Algeria, the default, TN for Tunisia or MA for Morocco. Only live countries answer: list_countries shows them and their datasets. Any other country, or a dataset the country does not have (for example the activity nomenclature for Morocco), returns country_not_available. Without an API key only DZ answers: TN and MA return key_required.

  Exemple d'appel

  {"name": "search_jo_titles", "arguments": {"q": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• search_post_offices≈ 796 tokens

  Search Algérie Poste's post offices (kind post_office, the default) or ATMs (kind atm) by name or address words (q, accents ignored), by postal code (all five digits, or the first ones), by commune code, by wilaya, or around a place (lat and lng in decimal degrees, within radius_km, 10 by default: nearest first, with distance_km). Each post office comes with its class, address, postal code and former postal code, GPS position and commune; each ATM with whether it works. Use it to find the post office of a postal code, the offices of a delivery zone, or the nearest office or ATM to an address. Data read from Algérie Poste every day. Without an API key, at most 10 rows. Algeria only.

  Paramètres, retour & exemple (12)

  Paramètres

  • q · string · optionnel
    Words of the name or the address, accents ignored.
  • lat · number · optionnel
    Latitude of the place to search around, with lng.
  • lng · number · optionnel
    Longitude of the place to search around, with lat.
  • kind · string · optionnel · post_office | atm
    post_office (default) or atm.
  • lang · string · optionnel · fr | ar | en
    Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English).
  • limit · integer · optionnel
    Maximum number of results in the page, from 1 to 100. Defaults to 20. Without an API key at most 10 rows come back.
  • offset · integer · optionnel
    Number of results to skip, from 0 to 10000, to read the next pages. Defaults to 0. meta.total tells how many results match. Without an API key it must be 0: a search cannot be paged.
  • wilaya · string · optionnel
    A wilaya number from 1 to 69, or the slug of a wilaya created in 2026.
  • commune · string · optionnel
    A four-digit commune code.
  • country · string · optionnel
    Country of the data, an ISO 3166-1 alpha-2 code in any letter case: DZ for Algeria, the default, TN for Tunisia or MA for Morocco. Only live countries answer: list_countries shows them and their datasets. Any other country, or a dataset the country does not have (for example the activity nomenclature for Morocco), returns country_not_available. Without an API key only DZ answers: TN and MA return key_required.
  • radius_km · integer · optionnel
    Search radius around lat and lng, in km (10 by default).
  • postal_code · string · optionnel
    A postal code, or its first digits (16 for every code of wilaya 16).

  Exemple d'appel

  {"name": "search_post_offices", "arguments": {"q": "texte", "lat": 1, "lng": 1, "kind": "post_office", "lang": "fr", "limit": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• search_tax_code≈ 943 tokens

  Search the six tax codes of Algeria in their 2026 editions, as the Direction générale des impôts (DGI) publishes them, article by article: cidta (Code des impôts directs et taxes assimilées: IRG, IBS, IFU, TAP), cpf (Code des procédures fiscales: audits, assessments, penalties, appeals, limitation periods), ctca (Code des taxes sur le chiffre d'affaires: VAT), ce (Code de l'enregistrement: registration duties), cii (Code des impôts indirects) and ct (Code du timbre: stamp duty). Every word of q must appear in the article, in French, accents and case ignored (for example taux normal, retenue source, prescription); a phrase between quotes is searched as it is. Each match gives the code and its title, the article number (id, for example 150, 282 quater or 300-3), its heading (the part, title, chapter and section above it), its status (in_force or abrogated), an excerpt of about 300 characters around the rarest word and the link to the official PDF of the code; get_tax_code_article then returns the whole article with its notes. Best matches first: more hits first, a hit in the heading or at the start of the text counts more, abrogated articles rank low. Use it to find which article sets a rate, a deadline, a penalty or a condition, then read that article before quoting it, and name it by code and number (for example CIDTA art. 150). The text is the DGI's consolidated edition: the legal reference stays the Journal officiel, so read the notes of the article, which name the finance laws that created or amended it, and use get_jo_act to read such a law. Filter by code. Without an API key, at most 10 matches. Algeria only (country DZ); other countries return country_not_available.

  Paramètres, retour & exemple (6)

  Paramètres

  • q · string · requis
    Words that must all appear in the article (French, accents and case ignored), for example taux normal, retenue source, prescription. A phrase between quotes is searched as it is.
  • code · string · optionnel · cidta | cpf | ctca | ce | cii | ct
    Only this code: cidta (direct taxes and similar taxes), cpf (tax procedures), ctca (turnover taxes, VAT), ce (registration), cii (indirect taxes) or ct (stamp duty). All six when left out.
  • lang · string · optionnel · fr | ar | en
    Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English).
  • limit · integer · optionnel
    Maximum number of results in the page, from 1 to 100. Defaults to 20. Without an API key at most 10 rows come back.
  • offset · integer · optionnel
    Number of results to skip, from 0 to 10000, to read the next pages. Defaults to 0. meta.total tells how many results match. Without an API key it must be 0: a search cannot be paged.
  • country · string · optionnel
    Country of the data, an ISO 3166-1 alpha-2 code in any letter case: DZ for Algeria, the default, TN for Tunisia or MA for Morocco. Only live countries answer: list_countries shows them and their datasets. Any other country, or a dataset the country does not have (for example the activity nomenclature for Morocco), returns country_not_available. Without an API key only DZ answers: TN and MA return key_required.

  Exemple d'appel

  {"name": "search_tax_code", "arguments": {"q": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

C'est votre serveur ?

Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».

Créer un compte / revendiquer →

Source

https://www.upgrowth.dz/mcp