Install Jentic One Beta

Connect the Mtaa API Documentation to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Mtaa API Documentation, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fmtaa-api.herokuapp.com%2Fmtaa-api" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fmtaa-api.herokuapp.com%2Fmtaa-api" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Mtaa API Documentation API.

Retrieve every region in a country via GET /{country}

List the districts within a Tanzanian region via GET /{country}/{region}

List the wards within a district via GET /{country}/{region}/{district}

List the streets within a ward via GET /{country}/{region}/{district}/{ward}

Confirm a specific street within the full hierarchy via GET /{country}/{region}/{district}/{ward}/{street}

GET STARTED

Start building with Mtaa API Documentation API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use Mtaa API Documentation API for, with concrete tasks.

★ Tanzanian Address Dropdowns at Checkout

Local e-commerce checkouts need the user to pick region, district, ward, and street rather than typing free-text. The Mtaa API returns each level as the previous one is selected, so the dropdown chain stays consistent with official Tanzanian administrative names. The hierarchy avoids spelling drift between vendors and lines up with delivery courier zone naming.

Call GET /tanzania to populate the region dropdown, then on selection call GET /tanzania/{region} for districts, /tanzania/{region}/{district} for wards, and /tanzania/{region}/{district}/{ward} for streets.

Delivery Zone Validation for Logistics

Last-mile delivery platforms validate that a customer-supplied ward and street pair exists within a chosen district before assigning a courier. Calling /{country}/{region}/{district}/{ward}/{street} confirms the full path resolves to a real entry. Failed validation routes the address to manual review instead of dispatching a rider to a nonexistent location.

Call GET /tanzania/{region}/{district}/{ward}/{street} with the customer-supplied path and reject the order if the response is empty.

Government Services Form Population

Public sector forms in Tanzania ask citizens to identify their location by region down to ward. Using Mtaa's hierarchy ensures the form values match the administrative records held by national agencies, which avoids reconciliation work later. The API hierarchy mirrors the official PORALG administrative structure used for elections and census data.

Pull GET /tanzania once per session and cache, then progressively call deeper levels as the citizen narrows their location selection.

Agent-Driven Address Capture in Chat

An AI customer support agent confirms a Tanzanian customer's delivery address conversationally. Through Jentic the agent searches for 'list tanzania regions', then drills the hierarchy as the customer answers each clarifying question. The unauthenticated API means no credentials to manage and the agent only needs to chain four operations.

Search Jentic for 'list tanzania regions', call GET /tanzania, ask the user to pick one, then chain through district, ward, and street with each subsequent answer.

Key Endpoints

5 endpoints — the mtaa api exposes tanzania's administrative geography as a hierarchical rest endpoint, returning regions, districts, wards, and streets for the country.

METHOD

PATH

DESCRIPTION

GET

/{country}

List regions in a country

GET

/{country}/{region}

List districts in a region

GET

/{country}/{region}/{district}

List wards in a district

GET

/{country}/{region}/{district}/{ward}

List streets in a ward

GET

/{country}/{region}/{district}/{ward}/{street}

Validate a specific street in the hierarchy

GET

/{country}

List regions in a country

GET

/{country}/{region}

List districts in a region

GET

/{country}/{region}/{district}

List wards in a district

GET

/{country}/{region}/{district}/{ward}

List streets in a ward

GET

/{country}/{region}/{district}/{ward}/{street}

Validate a specific street in the hierarchy

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring the Mtaa API by hand means encoding the Tanzanian administrative hierarchy into nested path segments yourself, from country down through region, district, ward, and street. Through Jentic you install once, import the Mtaa API from the API Directory, and your agent calls it, with no credential to manage because the endpoints are unauthenticated.

Permission scoping

Every operation here is a read-only lookup down the administrative hierarchy, so limit the agent to the operations it needs, such as listing regions or resolving a ward. You choose which hierarchy operations are in scope, and nothing beyond those reads is reachable.

Credential isolation

The Mtaa API requires no credential, so there is nothing to store, and your agent reaches only the hierarchy operations you allow. No secret ever enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'list tanzania regions' or 'resolve a ward in a district', and Jentic returns the matching Mtaa operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

OpenStreetMap API

OpenStreetMap exposes administrative boundaries globally including Tanzania

Pick OpenStreetMap when the workflow needs polygon geometry or coverage outside Tanzania.

Alternative

Positionstack API

Positionstack offers global forward and reverse geocoding including African addresses

Choose Positionstack when the requirement is converting a free-text address to coordinates rather than walking a fixed administrative hierarchy.

Complementary

LocationIQ API

LocationIQ adds geocoding and routing on top of an address lookup

Pair with Mtaa when the validated ward or street needs to be turned into latitude and longitude for a delivery dispatch.

FAQs

Specific to using Mtaa API Documentation API through Jentic.

What authentication does the Mtaa API use?

The Mtaa API is unauthenticated - every endpoint is a public GET with no key or token required. Through Jentic the agent calls the hierarchy operations directly with no credential setup.

Can I drill from country down to street level?

Yes. The five endpoints chain by path segment - /{country}, /{country}/{region}, /{country}/{region}/{district}, /{country}/{region}/{district}/{ward}, and /{country}/{region}/{district}/{ward}/{street}. Each level returns the children at the next level.

What are the rate limits for the Mtaa API?

The Mtaa API runs on a community Heroku deployment and applies no published rate limit, but it can sleep when idle so cold-start latency is realistic. Cache the GET /{country} and region-level responses on your side rather than hitting the API on every page render.

How do I populate an address dropdown through Jentic?

Search Jentic for 'list tanzania regions', execute GET /tanzania, then on each user selection call the next deeper endpoint - /tanzania/{region}, /tanzania/{region}/{district}, and so on. The agent receives clean lists ready to render in dropdowns.

Is the Mtaa API free?

Yes. The Mtaa API is an open community project hosted on Heroku and does not charge per call. Plan for occasional cold starts and consider mirroring the data locally for production use.

Can I limit what my agent is allowed to do with the Mtaa API?

Yes. Because you run Jentic One yourself, your own rules decide which Mtaa operations the agent may call. Every operation is a read-only lookup down the Tanzanian administrative hierarchy, so you can grant only the levels you need, such as listing regions or resolving a specific ward or street, and leave the deeper lookups out of scope. Nothing beyond the reads you allow is reachable, and since the API needs no credential there is no key for the agent to hold.

Mtaa API Documentation

Name: Mtaa API Documentation API
Brand: Mtaa API Documentation
Availability: InStock

Community OpenAPI document · agent-readyMaps GeolocationGeocodingnone5 EndpointsREST

Know of an official OpenAPI document? Contribute it →

For Agents

Look up Tanzania's administrative geography - region, district, ward, street - through a hierarchical lookup API used to populate address selectors and validate locations.

Use for: I need to populate a cascading address dropdown for Tanzania, List every region in Tanzania, Get the districts in Dar es Salaam region, Find all wards in Kinondoni district

Not supported: Does not handle geocoding to latitude and longitude, routing, or non-Tanzanian geographies - use for walking the Tanzanian administrative hierarchy only.

The Mtaa API exposes Tanzania's administrative geography as a hierarchical REST endpoint, returning regions, districts, wards, and streets for the country. Developers building Tanzanian e-commerce checkouts, government service portals, or delivery platforms use it to populate cascading address selectors that match official local divisions. The five-endpoint surface walks the country down to street level by passing each level as a path segment.

Jentic One on Github View OpenAPI Document