UpGrowth: business data for Algeria, Tunisia and Morocco
RemoteAbout UpGrowth: business data for Algeria, Tunisia and Morocco
UpGrowth is a hosted MCP server for official business and company-formation data in Algeria, Tunisia, and Morocco. It serves entrepreneurs and professionals with country-specific legal, tax, social-contribution, and gazette records, each linked to its source.
Key features
- 01Country and dataset directory
- 02Business activity and legal-form lookup
- 03Tax and social-contribution data
- 04Gazette and customs tariff search
- 05CASNOS and IFU estimates
- 06Source links and record dates
Use cases
- 01Check activity codes and company-registration steps
- 02Review tax rates and payroll contributions
- 03Find official gazette records and customs chapters
MCP support
Exposes business-data lookup and calculation tools to MCP clients over hosted streamable HTTP. Clients connect to `https://www.upgrowth.dz/mcp`.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://www.upgrowth.dz/mcpclaude mcp add --transport http z4kary-upgrowth https://www.upgrowth.dz/mcp{"mcpServers":{"z4kary-upgrowth":{"type":"http","url":"https://www.upgrowth.dz/mcp"}}}Open in Cursor{"servers":{"z4kary-upgrowth":{"type":"http","url":"https://www.upgrowth.dz/mcp"}}}Open in VS Code{"mcpServers":{"z4kary-upgrowth":{"type":"http","url":"https://www.upgrowth.dz/mcp"}}}{"mcpServers":{"z4kary-upgrowth":{"serverUrl":"https://www.upgrowth.dz/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
https://www.upgrowth.dz/mcpAuth requiredTools
28| Parameter | Type | Required | Description |
|---|---|---|---|
| q | string | No | 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 | enum | No | Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English).fr | ar | en |
| list | enum | No | 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.nat | authorisations |
| limit | integer | No | 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 | No | 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 | enum | No | 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).1 | 2 | 3 | 4 | 5 | 6 | 7 | A | B | C | D | E | F | G | H | I | J | K | L | M | N | O | P | Q | R | S | T | U |
| status | enum | No | Keep only activities with this status: libre (free, no specific authorization needed to register), reglementee (regulated, a prior authorization or permit is required) or bloquee (blocked, cannot be registered in the trade register). 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.libre | reglementee | bloquee | not_determined |
| country | string | No | 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. |
Details
From the project READMEUpGrowth MCP server: business data for Algeria, Tunisia and Morocco
A hosted Model Context Protocol server by UpGrowth (Algiers). It gives AI assistants the official public data on creating and running a company in North Africa, with the official source of every record.
- Endpoint (streamable HTTP):
https://www.upgrowth.dz/mcp - REST API and documentation: https://www.upgrowth.dz/api (OpenAPI: https://www.upgrowth.dz/api/v1/openapi.json)
- Free tier: no sign-up, 100 calls a day, credit UpGrowth with a link.
- Paid plans (professionals, teams, platforms, data licences): https://www.upgrowth.dz/api, by application.
Connect
Claude (claude.ai or Claude Desktop): Settings, Connectors, Add custom connector, URL https://www.upgrowth.dz/mcp.
ChatGPT: add it as a custom connector (developer mode) with the same URL.
Cursor, VS Code and other MCP clients:
{
"mcpServers": {
"upgrowth": { "url": "https://www.upgrowth.dz/mcp" }
}
}
With a paid plan, add the header Authorization: Bearer <your key>.
What it covers
| Country | Data |
|---|---|
| Algeria | CNRC activity codes (2,136, with free, regulated or blocked status), ANAE auto-entrepreneur activities, wilayas, Journal officiel index 1962 to 2026 with search in the issue summaries, customs tariff sections and chapters, legal forms with official fees, CASNOS and IFU 2026 calculators, tax rates, social contributions, institutions |
| Tunisia | 24 governorates, legal forms with the RNE steps and fees, tax rates 2026, CNSS contributions and payroll levies, institutions |
| Morocco | 12 regions, legal forms with the CRI steps and fees, tax rates 2026, CNSS and AMO contributions, institutions, Bulletin officiel index 1912 to 2026 (French edition) |
More countries are added over time; list_countries always gives the current list.
Tools
| Tool | What it answers |
|---|---|
list_countries | Countries covered, with their datasets |
search_activity_codes, get_activity_code | Algerian CNRC activity codes |
search_anae_activities, get_anae_activity | Algerian auto-entrepreneur activities |
list_wilayas, get_wilaya | Algerian wilayas, Tunisian governorates, Moroccan regions (country) |
list_jo_years, list_jo_issues, get_jo_issue | Official gazette indexes: Algeria (JORA), Morocco (Bulletin officiel) |
search_jo_titles | Titles of the texts in the Algerian Journal officiel summaries |
customs_tariff_sections, customs_tariff_chapters | Algerian customs tariff |
creation_legal_forms | Legal forms, partners, minimum capital, steps and official fees (country) |
calculate_casnos, calculate_ifu | Algerian 2026 social contribution and flat tax estimates |
get_tax_rates | Corporate tax, VAT, withholding and income tax rates (country) |
get_social_contributions | Social contributions and payroll levies (country) |
list_institutions | Registries, investment agencies, tax and social bodies (country) |
Every tool takes an optional country (ISO code, default DZ).
Sources and accuracy
Each record carries the official page it was read from and the date. UpGrowth is a private company, not an official source; the calculators give estimates, not tax advice. Report an error: [email protected].
Terms
Free use by AI assistants and individuals with the credit line returned in meta.attribution: "Data from UpGrowth (https://www.upgrowth.dz)". Redistribution or bulk use needs a data licence: https://www.upgrowth.dz/api.
Contact
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.