Model Context Protocol

POST/api/mcp

Call every Angola utility as an MCP tool over one hosted endpoint

The public MCP server exposes all 25 Angola utility tools — salary, phone, geo, address, calendar, finance, currency, NIF, translation, and document generation — over a single Streamable HTTP endpoint. Point any MCP-compatible client at it and discover the tools via tools/list.

Streamable HTTP; SSE is disabled — use the mcp-remote bridge for SSE-only clients.

Tools

25 tools

Transport

Streamable HTTP

Locales

7 languages

Connect a client

Add the hosted endpoint to your MCP client. Transport is Streamable HTTP (POST /api/mcp); SSE is disabled. No API key is required — the endpoint is public. Some clients name the transport "streamable-http" or "transport": "http" instead of "http".

Claude Desktop

{  "mcpServers": {    "orb3x-utils": {      "command": "npx",      "args": ["-y", "mcp-remote", "https://utils.api.orb3x.com/api/mcp"]    }  }}

Cursor

{  "mcpServers": {    "orb3x-utils": {      "url": "https://utils.api.orb3x.com/api/mcp"    }  }}

Generic mcp.json

{  "mcpServers": {    "orb3x-utils": {      "type": "http",      "url": "https://utils.api.orb3x.com/api/mcp"    }  }}

mcp-remote bridge

npx -y mcp-remote https://utils.api.orb3x.com/api/mcp

Claude Desktop has no remote URL field in claude_desktop_config.json — use the mcp-remote bridge above, or add https://utils.api.orb3x.com/api/mcp directly via Settings → Connectors → Add custom connector.

Platform

Liveness and server-health tooling.

Tool	Description	Docs
health	Check that the MCP server is up and responding.	api-reference

Salary tools

Angola payroll math: net pay, gross-up, and total employer cost.

Tool	Description	Docs
salary_net	Compute net salary after IRT and social security from a gross figure.	salary
salary_gross	Work backwards from a target net salary to the required gross.	salary
salary_employer_cost	Compute the total employer cost including social-security contributions.	salary

Phone tools

Parse, validate, and identify the operator for Angolan phone numbers.

Tool	Description	Docs
phone_parse	Parse an Angolan phone number into its structured components.	phone
phone_validate	Validate whether a string is a well-formed Angolan phone number.	phone
phone_operator	Identify the mobile operator for an Angolan phone number.	phone

Address & geography tools

Normalize addresses and browse the province/municipality/commune hierarchy.

Tool	Description	Docs
address_normalize	Normalize a free-form Angolan address into structured components.	address-geo
address_suggest	Suggest matching address completions from a partial input.	address-geo
geo_provinces	List all Angolan provinces.	address-geo
geo_municipalities	List the municipalities within a province.	address-geo
geo_communes	List the communes within a municipality.	address-geo

Calendar tools

Angolan public holidays and working-day arithmetic.

Tool	Description	Docs
calendar_holidays	List Angolan public holidays for a given year.	calendar
calendar_working_days	Count working days between two dates, excluding holidays.	calendar
calendar_add_working_days	Add a number of working days to a date, skipping holidays.	calendar

Finance tools

VAT, invoice totals, and inflation adjustment.

Tool	Description	Docs
finance_vat	Compute Angolan VAT for a given amount and rate.	finance
finance_invoice_total	Compute an invoice total from line items with VAT applied.	finance
finance_inflation_adjust	Adjust a monetary amount for inflation between two dates.	finance

Currency tools

Live exchange rates and currency conversion.

Tool	Description	Docs
currency_rates	Fetch current exchange rates for a base currency.	currency-exchange
currency_convert	Convert an amount from one currency to another at the live rate.	currency-exchange

NIF lookup

Look up a taxpayer by NIF on the live AGT portal.

Tool	Description	Docs
nif_lookup	Look up a NIF on the AGT portal. Live scrape — 5–30 s; set generous timeouts.	nif-verification

Translation

Translate text between languages.

Tool	Description	Docs
translate_text	Translate text and detect the source language.	translation

Document generation

Generate Angola-format PDF documents.

Tool	Description	Docs
generate_invoice_pdf	Generate an invoice PDF from structured data.	documents
generate_receipt_pdf	Generate a receipt PDF from structured data.	documents
generate_contract_pdf	Generate a contract PDF from structured data.	documents

Performance & latency

The nif_lookup tool scrapes the live AGT portal, so it is far slower than the pure-function tools.

AGT portal lookups take 5–30 s. Set generous client timeouts; the server already enforces a ~25 s upstream cap.