Openapi®

io.github.openapiPublished by GitHub account openapiv0.3.1Updated Oct 30, 2026

Official Openapi® MCP server: Italian company data, PEC, SMS, vehicles, geocoding and more APIs.

VerifiedStreamable HTTPWeb executableLocation & Lifestyle Security & Monitoring Business & Commerce

Server details

Identifier: io.github.openapi/mcp-server
Transport: Streamable HTTP
Runtime: Web executable
Trust: Verified
Published: Oct 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account openapi for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.openapi%2Fmcp-server.svg)](https://sourceweft.com/mcp/io.github.openapi%2Fmcp-server?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Official Openapi MCP server for Italian and international company data, PEC, SMS, vehicle, geocoding, email and IP checks, and document services.

What you can do: Look up company profiles and financials: Italian, EU and worldwide companies by VAT or tax code, plus Italian company search and legal-form lists
Retrieve Italian registry reference data: regions, provinces, metropolitan cities, municipalities, ISTAT codes and ZIP lookups
Run risk and identity checks: KYC screening, Italian credit scores, fiscal code validation, email, mobile, IP and URL reputation checks
Send SMS and check PEC certified email availability
Geocode and reverse geocode addresses, and look up license plates and daily exchange rates
Request and download Italian official company documents, and list or track DocuEngine services and requests
When to use it: Useful when an assistant needs verified business registry, financial or risk data on Italian or international companies, or when it must validate contact details, addresses and vehicles. Also fits workflows that send SMS, check PEC addresses or fetch official Italian company documents.
Requirements: Remote endpoint at mcp.openapi.com, or the openapi-mcp-sdk Python package run locally (uvx, pipx or pip) with Python. An Openapi bearer token created in the Openapi console with the needed scopes, sent in the Authorization header. The self-hosted server stores downloaded documents locally or in GCS/S3 and needs MCP_BASE_URL set to its public address for download links.

Before you install

The Authorization bearer token is a paid-service credential with scopes; keep it out of shared configs, and note the README's ?token= URL option exposes it in the URL. Tools send SMS, create KYC requests and order official company documents, which may incur charges or create records. Email, mobile, IP and URL checks send personal or network identifiers to a third party. The self-hosted server prints request headers and parameters to stdout.

Installation

In SourceWeft

Open Openapi® in the dashboard and add it to a workspace.
Connect Authorization token credentials. They are stored privately and never shown on public pages.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.openapi%2Fmcp-server/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "openapi": {
      "type": "http",
      "url": "https://mcp.openapi.com/",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

[OpenAPI Pulse — this week in the OpenAPI community]

[Openapi MCP]

🔐 Openapi® MCP

The official Python MCP SDK and ready-to-run MCP server for Openapi®

[build] [PyPI] [Python] [License] [MCP]
[Linux Foundation Member]

Overview

Welcome to openapi-mcp-sdk, this is the official openapi.com MCP SDK. It ships as a Python package on PyPI and can be used in two ways:

Ready-to-use server — run the MCP gateway directly from the package with a single command, no cloning or setup required.
Python library — import openapi_mcp_sdk in your own project to build a custom MCP server that wraps openapi.com APIs with your own logic, tools, or auth layer on top.

Environment variables

All configuration is done through environment variables. None are required to start the server — defaults are suitable for local use.

Core

Variable	Default	Description
`MCP_PORT`	`8080`	HTTP port the server listens on
`MCP_ENV`	`production`	Runtime environment: `dev` \| `staging` \| `production`
`MCP_BASE_URL`	`http://localhost:8080`	Public URL of this server (used to build callback and file download URLs)
`MCP_CALLBACK_URL`	`$MCP_BASE_URL/callbacks`	Explicit callback URL sent to async APIs
`MCP_OPENAPI_ENV`	(empty)	Openapi environment: `dev`, `test`, `sandbox` (alias of `test`), or empty for production

Storage

The server needs to store files for APIs that return binary documents (e.g. company official documents). The storage backend is configurable:

Variable	Default	Description
`MCP_STORAGE_BACKEND`	`local`	`local` \| `gcs` \| `s3`
`MCP_STORAGE_PATH`	`./openapi_storage`	Local path for `local` backend
`MCP_STORAGE_BUCKET`	(required for cloud)	Bucket name for `gcs` or `s3`
`MCP_STORAGE_REGION`	(required for s3)	AWS region for the S3 bucket

Cache

Used to share async callback results across multiple server instances.

Variable	Default	Description
`MCP_CACHE_BACKEND`	`none`	`none` (in-process dict) \| `memcached` \| `redis`
`MCP_CACHE_URL`	(none)	Redis connection URL (`MCP_CACHE_BACKEND=redis`), e.g. `redis://host:6379`
`MCP_CACHE_HOST`	(none)	Memcached host (`MCP_CACHE_BACKEND=memcached`)
`MCP_CACHE_PORT`	`11211`	Memcached port

See docs/env/ for per-environment configuration guides (local, Docker, AWS, GCP, Kubernetes).

Features

Secure proxy: Pass-through of the Bearer Token provided by the client, without direct handling of sensitive credentials.
Extensible: Easily add new tools/APIs by creating modules in /apis/.
MCP-compatible: Designed according to MCP protocol best practices.
Modular: All API call logic and tool registration is centralized in mcp_core.py.

Quick Start — run from PyPI (recommended)

No cloning, no virtual environment. Start the server in one command:

The server starts immediately at http://localhost:8080.

Other runtimes

bash

# pipx (ephemeral run, no install needed — similar to uvx)pipx run openapi-mcp-sdk server
# pip (installs the package, then run the command)pip install openapi-mcp-sdk && openapi-mcp-sdk server
# pip3 on systems where python3 is the defaultpip3 install openapi-mcp-sdk && openapi-mcp-sdk server

# pipx (ephemeral run, no install needed — similar to uvx)pipx run openapi-mcp-sdk server
# pip (installs the package, then run the command)pip install openapi-mcp-sdk && openapi-mcp-sdk server
# pip3 on systems where python3 is the defaultpip3 install openapi-mcp-sdk && openapi-mcp-sdk server

CLI reference

openapi-mcp-sdk <command>
Commands:  server   Start the MCP server (HTTP/SSE, default port 8080)  ping     Ping the openapi.com APIs and report latency       [coming soon]  token    Generate or inspect an openapi.com Bearer token    [coming soon]

openapi-mcp-sdk <command>
Commands:  server   Start the MCP server (HTTP/SSE, default port 8080)  ping     Ping the openapi.com APIs and report latency       [coming soon]  token    Generate or inspect an openapi.com Bearer token    [coming soon]

Running with Docker

The project ships a single compose.yml with the mcp service.

bash

# Build and start (production-like image)docker compose up --build
# Run in backgrounddocker compose up --build -d
# Follow logsdocker compose logs -f mcp

# Build and start (production-like image)docker compose up --build
# Run in backgrounddocker compose up --build -d
# Follow logsdocker compose logs -f mcp

The server will be accessible at http://localhost:8080.

Debug and Development

Local development (without Docker)

The fastest iteration loop runs the server directly with uvicorn:

This sets PYTHONPATH=src and starts uvicorn with auto-reload disabled. The server listens on http://0.0.0.0:8080.

To test endpoints manually:

The server prints request headers and parameters to stdout — no extra configuration needed.

Remote debugging with VS Code and Docker (one click)

The repository is pre-configured for a single-click debug experience. No manual steps, no editing compose files, no terminal commands.

How it works

File	Role
`docker/dev/Dockerfile`	Debug image — adds `debugpy`, exposes port 5678
`compose.yml`	Compose config — dev image, debug ports, bind mount
`.vscode/tasks.json`	VS Code tasks — starts/stops the container automatically
`.vscode/launch.json`	Launch config — ties everything together under F5

Workflow

Set your breakpoints anywhere in src/.
Open Run and Debug (Ctrl+Shift+D / ⌘+Shift+D).
Select MCP: Debug (Docker) from the dropdown.
Press F5.

VS Code will:

Build the debug image (docker/dev/Dockerfile) if needed.
Start the container via compose.yml (debug image + bind mount).
Wait automatically until debugpy is accepting connections on port 5678.
Attach debugpy — your breakpoints are now live.

When you press ⇧F5 (Stop), VS Code detaches and tears down the container.

Keep the container alive after detaching? Remove the "postDebugTask" line from .vscode/launch.json. You can then re-attach at any time by pressing F5 again without rebuilding.

Live code reload

compose.yml bind-mounts ./src into /app/src inside the container. Edits to files under src/ are reflected immediately — no image rebuild required. Just send a new request and the updated code runs.

Path mapping reference

Authentication

The server accepts the Bearer token in two ways:

Option A — Authorization header (recommended)

Pass the token as a standard HTTP header:

Option B — `?token=` query parameter

Some MCP clients or environments do not support custom HTTP headers. In that case the token can be embedded directly in the server URL as a query parameter:

The server automatically promotes it to an Authorization: Bearer header before the request reaches the MCP layer, so the behaviour is identical.

When to use ?token=: Claude Desktop (as of mid-2025), some browser-based MCP playgrounds, and any client whose configuration only accepts a plain URL without a headers field.

MCP Client Configuration (VS Code)

Generate a Bearer Token From the portal https://console.openapi.com/oauth, create a token with the required scopes.

Create the .vscode/mcp.json file

With header (recommended):

json

{  "servers": {    "openapi.com": {      "type": "http",      "url": "http://YOUR_SERVER_IP:8080/",      "headers": {        "Authorization": "Bearer YOUR_TOKEN"      }    }  }}

{  "servers": {    "openapi.com": {      "type": "http",      "url": "http://YOUR_SERVER_IP:8080/",      "headers": {        "Authorization": "Bearer YOUR_TOKEN"      }    }  }}

With ?token= query parameter (for clients that do not support custom headers):

json

{  "servers": {    "openapi.com": {      "type": "http",      "url": "http://YOUR_SERVER_IP:8080/?token=YOUR_TOKEN"    }  }}

{  "servers": {    "openapi.com": {      "type": "http",      "url": "http://YOUR_SERVER_IP:8080/?token=YOUR_TOKEN"    }  }}

Test the integration
- Reload VS Code.
- Open the Copilot chat and type @workspace.
- Use the tools exposed by the MCP server.

File storage

Some openapi.com APIs (e.g. visure camerali — Italian official company documents) return large binary files (ZIP archives, PDFs) that cannot be embedded inline in the MCP stream. The server downloads these files, stores them, and serves them via a separate HTTP endpoint (GET /status/{id}/files/{filename}).

Default: local filesystem

By default (MCP_STORAGE_BACKEND=local) files are written to ./openapi_storage relative to the directory from which the server is started:

Override the path with the MCP_STORAGE_PATH environment variable:

The directory is created automatically on first use. For the download links to work correctly, MCP_BASE_URL must point to the public address of the server (default: http://localhost:8080).

Cloud storage backends

`MCP_STORAGE_BACKEND`	Additional variables	Notes
`local`	`MCP_STORAGE_PATH` (default `./openapi_storage`)	Default — local disk or mounted volume
`gcs`	`MCP_STORAGE_BUCKET`	Google Cloud Storage
`s3`	`MCP_STORAGE_BUCKET`, `MCP_STORAGE_REGION`	AWS S3 or any S3-compatible service

See docs/env/ for full per-environment configuration guides.

Deployment environments

Project Structure

src/openapi_mcp_sdk/main.py: FastAPI + MCP server entry point.
src/openapi_mcp_sdk/mcp_core.py: MCP initialization, API call helpers, error handling.
src/openapi_mcp_sdk/apis/: Python modules defining MCP tools (one per API/scope).
requirements.txt: Python dependencies.
compose.yml: Docker Compose (production image by default; see comments to switch to debug).
docker/latest/Dockerfile: Production Docker image.
docker/dev/Dockerfile: Development image with debugpy for VS Code remote debugging.
.vscode/launch.json: VS Code debug configuration (attach to debugpy).
docs/: Documentation and example configurations.

Adding New Tools/APIs

Create or modify a file in /apis/, following this pattern:

python

from fastmcp import Contextfrom typing import Anyfrom mcp_core import make_api_call, mcp
@mcp.toolasync def tool_name(parameters..., ctx: Context) -> Any:    # ...logic...    return make_api_call(ctx, "GET", url, params=params)

from fastmcp import Contextfrom typing import Anyfrom mcp_core import make_api_call, mcp
@mcp.toolasync def tool_name(parameters..., ctx: Context) -> Any:    # ...logic...    return make_api_call(ctx, "GET", url, params=params)

Restart the server to apply the changes.

Security Notes

Never hardcode credentials or tokens in the code.
The server expects the Bearer Token to be provided by the client via HTTP headers.
All API calls are proxied using the token provided by the client.

Useful Resources

Contributing

Contributions are always welcome! Whether you want to report bugs, suggest new features, improve documentation, or contribute code, your help is appreciated.

See docs/contributing.md for detailed instructions on how to get started. Please make sure to follow this project's docs/code-of-conduct.md to help maintain a welcoming and collaborative environment.

Authors

Meet the project authors:

Simone Desantis (@SimoneDesantis)
Marco Prosperi (@MarcoProsperi)
Francesco Bianco (@francescobianco)
Openapi Team (@openapi-it)

Partners

Meet our partners using Openapi or contributing to this SDK:

License

This project is licensed under the MIT License.

The MIT License is a permissive open-source license that allows you to freely use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the software, provided that the original copyright notice and this permission notice are included in all copies or substantial portions of the software.

In short, you are free to use this SDK in your personal, academic, or commercial projects, with minimal restrictions. The project is provided "as-is", without any warranty of any kind, either expressed or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and non-infringement.

For more details, see the full license text at the MIT License page.

Source: README.md at commit 0fd4ca5

Tools

check_async_status

Show the last status of an async request Args: request_id: required, returned by an async downgraded request to the mcp server

Parametersrequest_idrequired

get_company_IT_full

Full italian companies data from VAT

Returns the complete and detailed profile of an Italian company given a VAT number or Tax Code. - Company Data (Name, VAT Number, Tax Code, CCIAA, and REA) - Managers - Registered Office and other types of offices - Activity Classifications (New ATECO 2025, ATECO history since 2022, NACE, SIC, RAE, and SAE) - Corporate Affiliation - Exporter / Importer Status - Company Size - Company Contacts (Email, phone, fax, website, social media) - Shareholders and their ownership shares - Employees, number, trends, statistics on contract duration and types - Regarding shareholders, it is possible to access the list of the top 10 (based on ownership share size) and view their respective ownership shares. - Liquidity and profitability - Receivables and Payables - EBITDA and EBIT - Cashflow with a 2-year history - Financial fixed assets - Production value and costs - Financial revenues and expenses - Tangible, intangible, and financial assets - Net profit/loss Use get_company_IT_search to obtain VAT Args: vat_or_taxCode: VAT number or Tax Code of an Italian company

Parametersvat_or_taxCoderequired

get_company_IT_advanced

Advanced italian companies data from VAT

Returns taxCode, companyName, vatCode,address,activityStatus,reaCode,cciaa,atecoClassification,detailedLegalForm,startDate,registrationDate,endDate,pec,taxCodeCeased,taxCodeCeasedTimestamp,vatGroup,sdiCode,sdiCodeTimestamp,balanceSheets (turnover,employee,networt,staffCost,totalAssets.avgGrossSalary of the last 10 years),shareHolders of an italian company from vatCode or taxCode. Args: vat_or_taxCode: vatCode or taxCode of an italian company

Parametersvat_or_taxCoderequired

get_company_IT_start

Start italian companies data from VAT

Returns taxCode,companyName,vatCode,address,activityStatus,sdiCode,registrationDate of an italian company from vatCode or taxCode. Args: vat_or_taxCode: vatCode or taxCode of an italian company

Parametersvat_or_taxCoderequired

get_company_IT_search

Search italian companies by advanced search criteria

Returns a list of italian companies based on the search criteria. Use this tool if you don't know the VAT number of a company. Use this tool with dryRun=1 and no limit parameter to get the count of available results for the matching criterias Use this tool if you need to extract enriched data (max 1000 records paginable with the skip parameter) like name, address, pec, start (all the data in the get_company_IT_start tool) or advanced (all the data in the get_company_IT_advanced tool) based on matching criterias. Args: companyName: The name or part of it of an Italian company (optional). provinceCode: The 2 letters provinceCode where the company is located to restrict the results (optional). skip: The number of records to skip for pagination (optional). limit: The maximum number of results to return (optional, default is 10), if you want to have the total count of records with matching criterias skip this parameter and set dryRun to 1. dataEnrichment: Avoid further queries receiving Additional data enrichment options in the results (default is name), multiple values are forbidden, Available values : start, advanced, pec, address, shareholders, name legalFormCode: Filter by legalformcode of the company (optional). For Available values use get_company_IT_legal_forms_list tool, multiple values are forbidden, possible values: ["EI","EL","OO","OS","RC","ST","AF","AP","AS","CO","EE","FO","SL","SR","SZ","AL","AN","CC","CF","EC","ED","EN","OC","PA","SF","SO","AA","AC","AI","AM","AT","CR","ES","GE","IF","LL","RS","SI","AR","CS","SA","SC","SD","SG","AE","EP","PF","SN","SP","XX","AU","CE","CI","CL","CN","CZ","DI","RR","SE","SU","AZ","CM","EM","ER","FI","IC","ID","IR","MA","PC","PS","SM","SS","SV"] startDate: Filter by the start date of the company (optional). endDate: Filter by the end date of the company (optional). dryRun: Simulates a request by returning only the number of records "count" found and the price "cost" (optional)

ParameterslatpeclongskipcciaalimitdryRunradiusendDatereaCodesdiCodetownCode+15 more

get_company_WW_top

Start worldwide companies data from VAT or company number

Returns companyName,nativeCompanyName,companySize,address,gps,activityStatus,incorporationDate,contacts,nace,nationalClassification,balanceSheets data like employees,netWorth,operatingRevenue,equity,totalAssets . Args: vat_or_taxCode: vatCode or taxCode of a company country_code: country code of the company

Parameterscountry_coderequiredvat_or_taxCoderequired

get_company_IT_legal_forms_list

Obtain all the updated legalFormsCodes and descriptions available in italy. Usefull with get_company_IT_search. "EI"="ENTE IMPRESA","EL"="ENTE SOCIALE","OO"="COOPERATIVA SOCIALE","OS"="SOCIETA' CONSORTILE COOPERATIVA A RESPONSABILITA' LIMITATA","RC"="CONTRATTO DI RETE DOTATO DI SOGGETTIVITA' GIURIDICA","ST"="SOGGETTO ESTERO","AF"="ALTRE FORME","AP"="AZIENDA PROVINCIALE","AS"="SOCIETA' IN ACCOMANDITA SEMPLICE","CO"="CONSORZIO","EE"="ENTE ECCLESIASTICO","FO"="FONDAZIONE","SL"="SOCIETA' CONSORTILE A RESPONSABILITA' LIMITATA","SR"="SOCIETA' A RESPONSABILITA' LIMITATA","SZ"="SOCIETA' NON PREVISTA DALLA LEGISLAZIONE ITALIANA","AL"="AZIENDA SPECIALE","AN"="SOCIETA' CONSORTILE IN NOME COLLETTIVO","CC"="CONSORZIO CON ATTIVITA' ESTERNA","CF"="CONSORZIO FIDI","EC"="ENTE PUBBLICO COMMERCIALE","ED"="ENTE DIRITTO PUBBLICO","EN"="ENTE","OC"="SOCIETA' COOPERATIVA CONSORTILE","PA"="ASSOCIAZIONE IN PARTECIPAZIONE","SF"="SOCIETA' DI FATTO","SO"="SOCIETA' CONSORTILE PER AZIONI","AA"="SOCIETA' IN ACCOMANDITA PER AZIONI","AC"="ASSOCIAZIONE","AI"="ASSOCIAZIONE IMPRESA","AM"="AZIENDA MUNICIPALE","AT"="AZIENDA AUTONOMA STATALE","CR"="CONSORZIO INTERCOMUNALE","ES"="ENTE DI CUI ALLA L.R. 21-12-93 N88","GE"="GRUPPO EUROPEO DI INTERESSE ECONOMICO","IF"="IMPRESA FAMILIARE","LL"="AZIENDA SPECIALE DI CUI AL DLGS 267/2000","RS"="SOCIETA' A RESPONSABILITA' LIMITATA SEMPLIFICATA","SI"="SOCIETA' IRREGOLARE","AR"="AZIENDA REGIONALE","CS"="CONSORZIO SENZA ATTIVITA' ESTERNA","SA"="SOCIETA' ANONIMA","SC"="SOCIETA' COOPERATIVA","SD"="SOCIETA' EUROPEA","SG"="SOCIETA' COOPERATIVA EUROPEA","AE"="SOCIETA' CONSORTILE IN ACCOMANDITA SEMPLICE","EP"="ENTE PUBBLICO ECONOMICO","PF"="PERSONA FISICA","SN"="SOCIETA' IN NOME COLLETTIVO","SP"="SOCIETA' PER AZIONI","XX"="NON PRECISATA","AU"="SOCIETA' PER AZIONI CON SOCIO UNICO","CE"="COMUNIONE EREDITARIA","CI"="SOCIETA' COOPERATIVA A RESPONSABILITA ILLIMITATA","CL"="SOCIETA' COOPERATIVA A RESPONSABILITA LIMITATA","CN"="SOCIETA' CONSORTILE","CZ"="CONSORZIO DI CUI AL DLGS

Takes no parameters.

get_company_EU_start

European/Worldwide basic company data

Returns basic company information for a company in the specified country. Returns: companyName, vatCode, address, activityStatus, and other basic details. Args: vatCode: VAT code or company registration number (e.g., DE123456789, FR12345678901234) country_code: Two-letter country code (e.g., DE, ES, PT, GB, BE, AT, CH, PL, FR)

ParametersvatCoderequiredcountry_coderequired

get_company_EU_advanced

European/Worldwide advanced company data

Returns advanced company information for a company in the specified country. Returns: Detailed company data including financial highlights or extended registry info where available. Args: vatCode: VAT code or company registration number country_code: Two-letter country code (e.g., FR, DE, ES, etc.)

ParametersvatCoderequiredcountry_coderequired

get_company_WW_start

Worldwide basic company data

Returns basic company information for a company worldwide. Args: vatCode: VAT code or company registration number country_code: Two-letter country code of the country

ParametersvatCoderequiredcountry_coderequired

get_company_WW_advanced

Worldwide advanced company data

Returns advanced company information for a company worldwide. Args: vatCode: VAT code or company registration number country_code: Two-letter country code of the country

ParametersvatCoderequiredcountry_coderequired

get_company_FR_search

Search French companies by advanced criteria

Returns a list of French companies based on the search criteria. Args: companyName: The name or part of it of a French company (optional). provinceCode: The department code or region to restrict search (optional). skip: The number of records to skip for pagination (optional). limit: The maximum number of results to return (optional, default 10). dataEnrichment: Enrichment options: start, advanced, name (default is name). dryRun: Set to 1 to only get count and cost (optional). nafCode: NAF Activity Code for the company (optional). activityStatus: Status of the company (optional).

ParametersskiplimitdryRunnafCodecompanyNameprovinceCodeactivityStatusdataEnrichment

get_IT_regions_list

Returns the list of Italian regions

Takes no parameters.

get_IT_provinces_list

Returns the list of Italian provinces

Takes no parameters.

get_IT_metropolitan_cities_list

Returns the list of Italian metropolitan cities

Takes no parameters.

get_suppressed_italian_municipalities

Returns the list of suppressed or merged Italian municipalities

Takes no parameters.

find_IT_istat_by_comune_name

Searches for the ISTAT code associated with a given Italian municipality.

Parameterscomunerequired

find_IT_municipality_by_istat

Retrieves detailed data about an Italian municipality using the ISTAT code: - istat:istatCode - comune:municipalityName - regione:regionName - provincia:provinceName - prefisso:telephoneLocalPrefix - cod_fisco:cadastralCodeor BelfioreCode of town, - superficie:surfaceArea - num_residenti:numberOfResidents - nome_abitanti:inhabitantsName - patrono.nomepatronSaintName, - patrono.datapatronSaintDate, - municipio:municipalityAddress - istat_old:oldIstatCode - sigla_provincia:provinceAbbreviation - email:emailAddress - pec:certifiedEmailAddress - tel:telephoneNumber - fax:faxNumber - frazioni:fractions - cap:postalCodes

ParametersistatCoderequired

find_IT_municipalities_by_zip

Retrieves the list of Italian municipalities and their ISTAT code based on the ZIP code.

Parameterszip_coderequired

check_email_start

Retrieves detailed information about an email address (spf, dmark, disposability, frauds) Args: email: the email to check

Parametersemailrequired

check_email_advanced

Retrieves advanced information about an email address (spfDetails, dmarcDetails, createdAt, updatedAt, state, message, success, valid, disposable, smtpScore, overallScore, firstName, generic, common, dnsValid, honeypot, deliverability, frequentComplainer, spamTrapScore, catchAll, timedOut, suspect, recentAbuse, fraudScore, suggestedDomain, leaked, sanitizedEmail, identityData, domainAge, firstSeen, riskyTld, spfRecord, dmarcRecord, mxRecords, aRecords) Args: email: the email to check

Parametersemailrequired

check_mobile_start

Retrieves basic information about a mobile number (requestedNumber, formattedNumber, numberType, isPossible, isValid, regionCode, isValidNumberForRegion, network, originalNetwork, roaming, ported, country, countryPrefix, details) Args: mobile: with international prefix es +39

Parametersmobilerequired

check_mobile_advanced

Retrieves advanced information about a mobile number (requestedNumber, formattedNumber, createdAt, updatedAt, state, message, success, valid, active, localFormat, fraudScore, recentAbuse, voip, prepaid, risky, name, identityData, carrier, lineType, country, region, city, accurateCountryCode, zipCode, timezone, dialingCode, doNotCall, leaked, spammer, activeStatus, mcc, mnc, transactionDetails) Args: mobile: with international prefix es +39

Parametersmobilerequired

check_ip_advanced

Retrieves advanced information about an ip address (ip, createdAt, updatedAt, state, requestedIp, message, success, proxy, host, isp, organization, asn, countryCode, city, region, timezone, latitude, longitude, zipCode, isCrawler, connectionType, recentAbuse, abuseVelocity, botStatus, frequentAbuser, highRiskAttacks, sharedConnection, dynamicConnection, securityScanner, trustedNetwork, operatingSystem, browser, deviceBrand, deviceModel, transactionDetails, errors, vpn, tor, activeVpn, activeTor, mobile, fraudScore) Args: ip: valid ip number

Parametersiprequired

check_url_advanced

Retrieves advanced information about an url address (url, createdAt, updatedAt, state, requestedUrl, message, success, unsafe, domain, ipAddress, countryCode, languageCode, server, contentType, statusCode, pageSize, domainRank, dnsValid, parking, pageTitle, shortLinkRedirect, hostedContent, riskyTld, spfRecord, dmarcRecord, mxRecords, nsRecords, aRecords, errors, riskScore, suspicious, phishing, malware, spamming, adult, category, technologies, domainAge, redirected, scannedUrl, finalUrl) Args: url: valid url address

Parametersurlrequired

get_italian_company_official_documents_list

Recupera un elenco di endpoint di visure camerali disponibili per una azienda da usare con il tool get_italian_company_official_document fornendo la sua Partita IVA o il suo Codice Fiscale. Args: vat_or_taxCode: vatCode or taxCode of an italian company

Parametersvat_or_tax_coderequired

get_italian_company_official_document

Recupera una visura camerale di una azienda fornendo la sua Partita IVA o il suo Codice Fiscale. Args: document_url: url of the requested document vat_or_taxCode: vatCode or taxCode of an italian company

Parametersdocument_urlrequiredvat_or_tax_coderequired

download_italian_company_official_document

Download a document when the "stato_richiesta" of a get_italian_company_official_document call is "Dati disponibili" Response is a json containing one or more files with attributes: file_name, file_size, download_link, content, expire. Args: document_id: the value id in return of a previous request. document_url: the value id in return of a previous request.

Parametersdocument_idrequireddocument_urlrequired

send_sms

Send an SMS to a mobile number using minus sign to separate international prefix from the number Args: sender: optional, can be a 11 char long string body: the body of the message string mobile: the recipient mobile number. Eg.:"+39-1234567890"

Parametersbodyrequiredmobilerequiredsenderrequired

post_risk_WW_kyc_full

Full Worldwide KYC FULL

This endpoint allows you to create a full kyc request on a subject (politically exposed person, adverse media, local politicians, legal enforcement, sanctions, whitelists) use name for entityType L,W,VE,AC,NA or firstName/lastName for entityType I Args: firstName: first name of the person lastName: lastName of the person entityType: can be I=Individual,L=Legal Entity,W=Website,VE=Vessel,AC=Aircraft,NA=Unknown name: the name of the entity if not Individual

ParametersnamerequiredlastNamerequiredfirstNamerequiredentityTyperequired

get_risk_IT_creditscore_top

Provides detailed credit score information for a specific organization using a tax code, VAT number

Returns Operational credit limits, Rating evaluations, Risk score history, Public ratings, Financial positions and profiles of an italian company from vatCode or taxCode. Args: vat_or_taxCode: vatCode or taxCode of an italian company

Parametersvat_or_taxCoderequired

check_IT_fiscal_code

Check if Italian Fiscal Code is real and existent in the official database

Check if an Italian Fiscal Code is real and existent in the official database. Args: fiscalCode: fiscal code of an italian person

ParametersfiscalCoderequired

geocode

Retrieve informations about a place supplying address. To improve success of results, please specify an address conforming to the following format: [street], [city] [postal code] [country] Args: address: string

Parametersaddressrequired

reverse_geocode

Get place information from ID or latitude/longitude: To obtain infos via ID make sure to pass the following format: {"type": "id", "id": "<id>"} To obtain infos via lat/long, make sure to provide the following format: {"type": "coordinates", "lat": "<lat>", "long": "<long>"} Args: type: required, can be "coordinates" or "id" id: string required only for type=id lat: the latitude number($float) example: 41.289294 long: the longitude number($float) example: 13.2349029

Parametersidrequiredlatrequiredlongrequiredtyperequired

check_license_plate

Retrieve informations about type=car,bike,insurance,mot from a countryCode=IT,FR,UK,DE,PT,ES and a licensePlate. Available Combinations: IT-car, IT-bike, IT-insurance,FR-car,FR-bike,UK-car,UK-bike,UK-mot,PT-car,PT-insurance,ES-car,ES-bike Args: countryCode: required, 2 digit country code (IT|FR|UK|DE|PT|ES) type: required, type of information needed (car|bike|insurance|mot) licensePlate: required, the license plate to check

ParameterstyperequiredcountryCoderequiredlicensePlaterequired

get_today_exchange_rates

Obtain daily world exchange rate based on USD value

Takes no parameters.

check_pec

Certified email address availability check

Checks if a specific PEC (Certified Email) address is available for purchase Use this tool when the user asks if a PEC address is avaible Args: pec: the pec address to check

Parameterspecrequired

get_docuengine_services

Returns the list of all available DocuEngine services with their required parameters.

Takes no parameters.

get_docuengine_request_status

Returns the details and status of a specific DocuEngine request.

Parametersrequest_idrequired

get_docuengine_documents

Returns the download links for the documents produced by a request.

Parametersrequest_idrequired

docuengine_visura_camerale_ordinaria_societa_di_capitale

Direct tool for DocuEngine service: Visura Camerale Ordinaria - Societa' Di Capitale (ID: 663df75d19a52195e23e315c). [Camerali] Visura Camerale Ordinaria - Societa' Di Capitale 💰 Price: €4.90 📋 Required: reaCode, cciaa

ParameterscciaarequiredreaCoderequired

docuengine_visura_camerale_ordinaria_societa_di_persone

Direct tool for DocuEngine service: Visura Camerale Ordinaria - Societa' Di Persone (ID: 6671a5549e6f0e447bc2659d). [Camerali] Visura Camerale Ordinaria - Societa' Di Persone 💰 Price: €3.40 📋 Required: reaCode, cciaa

ParameterscciaarequiredreaCoderequired

docuengine_visura_camerale_ordinaria_impresa_individuale

Direct tool for DocuEngine service: Visura Camerale Ordinaria - Impresa Individuale (ID: 6671a5719e6f0e447bc2659e). [Camerali] Visura Camerale Ordinaria - Impresa Individuale 💰 Price: €2.90 📋 Required: reaCode, cciaa

ParameterscciaarequiredreaCoderequired

docuengine_visura_camerale_storica_societa_di_capitale

Direct tool for DocuEngine service: Visura Camerale Storica - Societa' Di Capitale (ID: 6671a5a29e6f0e447bc2659f). [Camerali] Visura Camerale Storica - Societa' Di Capitale 💰 Price: €5.90 📋 Required: reaCode, cciaa

ParameterscciaarequiredreaCoderequired

docuengine_visura_camerale_storica_societa_di_persone

Direct tool for DocuEngine service: Visura Camerale Storica - Societa' Di Persone (ID: 6671a5bf9e6f0e447bc265a0). [Camerali] Visura Camerale Storica - Societa' Di Persone 💰 Price: €4.40 📋 Required: reaCode, cciaa

ParameterscciaarequiredreaCoderequired

docuengine_visura_camerale_storica_impresa_individuale

Direct tool for DocuEngine service: Visura Camerale Storica - Impresa Individuale (ID: 6671a5d69e6f0e447bc265a1). [Camerali] Visura Camerale Storica - Impresa Individuale 💰 Price: €3.90 📋 Required: reaCode, cciaa

ParameterscciaarequiredreaCoderequired

docuengine_bilancio_ottico

Direct tool for DocuEngine service: Bilancio Ottico (ID: 667443c29e6f0e447bc265aa). [Camerali] Bilancio Ottico 💰 Price: €4.50 (search: €0.10, document: €4.40) 📋 Required: taxCode 🔍 Two-step process: This returns search results. Use 'patch_docuengine_bilancio_ottico' to select and finalize.

ParameterstaxCoderequired

patch_docuengine_bilancio_ottico

Finalize selection for DocuEngine service: Bilancio Ottico. Use this AFTER calling 'docuengine_bilancio_ottico' when it returns a list of options. Provide the 'id' from your chosen option, and 'year' if applicable (e.g., for balance sheets). Example: If the search returned options with 'id' and 'year' fields, pass those values here.

Parametersidrequiredyearrequest_idrequired

docuengine_bilancio_xbrl

Direct tool for DocuEngine service: Bilancio XBRL (ID: 667c131a9e6f0e447bc265c1). [Camerali] Bilancio XBRL 💰 Price: €4.50 (search: €0.10, document: €4.40) 📋 Required: taxCode 🔍 Two-step process: This returns search results. Use 'patch_docuengine_bilancio_xbrl' to select and finalize.

ParameterstaxCoderequired

patch_docuengine_bilancio_xbrl

Finalize selection for DocuEngine service: Bilancio XBRL. Use this AFTER calling 'docuengine_bilancio_xbrl' when it returns a list of options. Provide the 'id' from your chosen option, and 'year' if applicable (e.g., for balance sheets). Example: If the search returned options with 'id' and 'year' fields, pass those values here.

Parametersidrequiredyearrequest_idrequired

docuengine_visura_camerale_inglese

Direct tool for DocuEngine service: Visura Camerale Inglese (ID: 66840ce41a241a5d1be0f9e5). [Camerali] Visura Camerale Inglese 💰 Price: €6.50 📋 Required: taxCode

ParameterstaxCoderequired

docuengine_atto_ottico

Direct tool for DocuEngine service: Atto Ottico (ID: 6687eea71a241a5d1be0f9f9). [Camerali] Atto Ottico 💰 Price: €5.50 (search: €0.60, document: €4.90) 📋 Required: taxCode 🔍 Two-step process: This returns search results. Use 'patch_docuengine_atto_ottico' to select and finalize.

ParameterstaxCoderequiredactGroupCoderequestDateTodocumentDateTorequestDateSincedocumentDateSince

patch_docuengine_atto_ottico

Finalize selection for DocuEngine service: Atto Ottico. Use this AFTER calling 'docuengine_atto_ottico' when it returns a list of options. Provide the 'id' from your chosen option, and 'year' if applicable (e.g., for balance sheets). Example: If the search returned options with 'id' and 'year' fields, pass those values here.

Parametersidrequiredyearrequest_idrequired

docuengine_statuto

Direct tool for DocuEngine service: Statuto (ID: 6687eed51a241a5d1be0f9fa). [Camerali] Statuto 💰 Price: €4.90 📋 Required: taxCode

ParameterstaxCoderequired

docuengine_bilancio_riclassificato

Direct tool for DocuEngine service: Bilancio Riclassificato (ID: 669533fe6d4f51cbde8da353). [Camerali] Bilancio Riclassificato 💰 Price: €5.00 (search: €0.10, document: €4.90) 📋 Required: taxCode 🔍 Two-step process: This returns search results. Use 'patch_docuengine_bilancio_riclassificato' to select and finalize.

ParameterstaxCoderequired

patch_docuengine_bilancio_riclassificato

Finalize selection for DocuEngine service: Bilancio Riclassificato. Use this AFTER calling 'docuengine_bilancio_riclassificato' when it returns a list of options. Provide the 'id' from your chosen option, and 'year' if applicable (e.g., for balance sheets). Example: If the search returned options with 'id' and 'year' fields, pass those values here.

Parametersidrequiredyearrequest_idrequired

docuengine_certificato_di_iscrizione

Direct tool for DocuEngine service: Certificato Di Iscrizione (ID: 689c99942d09c0a9bcb946e8). [Camerali] Certificato Di Iscrizione 💰 Price: €13.70 📋 Required: taxCode

ParametersphonetaxCoderequiredshippingAddressshipmentRecipient

docuengine_certificato_artigiano

Direct tool for DocuEngine service: Certificato Artigiano (ID: 689cb8852d09c0a9bcb946f3). [Camerali] Certificato Artigiano 💰 Price: €13.70 📋 Required: taxCode

ParametersphonetaxCoderequiredshippingAddressshipmentRecipient

docuengine_certificato_storico

Direct tool for DocuEngine service: Certificato Storico (ID: 689cb8972d09c0a9bcb946f5). [Camerali] Certificato Storico 💰 Price: €16.70 📋 Required: taxCode

ParametersphonetaxCoderequiredshippingAddressshipmentRecipient

docuengine_soci_attivi_azienda

Direct tool for DocuEngine service: Soci Attivi Azienda (ID: 6932c9602a2ea4883e6ebba9). [Camerali] Soci Attivi Azienda 💰 Price: €2.30 📋 Required: taxCode

ParameterstaxCoderequired

docuengine_eventi_negativi_persona

Direct tool for DocuEngine service: Eventi Negativi Persona (ID: 680a53e1cc53f5932b285b81). [Camerali] Eventi Negativi Persona 💰 Price: €3.90 📋 Required: name, surname, taxCode

ParametersnamerequiredsurnamerequiredtaxCoderequired

docuengine_visura_protesti_persona_fisica

Direct tool for DocuEngine service: Visura Protesti Persona Fisica (ID: 69b96b74327b41417c838fb0). [Camerali] Visura Protesti Persona Fisica 💰 Price: €0.90 📋 Required: name, surname, taxCode

ParametersnamerequiredsurnamerequiredtaxCoderequired

docuengine_visura_protesti_e_pregiudizievoli_persona_fisica

Direct tool for DocuEngine service: Visura Protesti E Pregiudizievoli Persona Fisica (ID: 69b96bc0327b41417c838fb1). [Camerali] Visura Protesti E Pregiudizievoli Persona Fisica 💰 Price: €3.70 📋 Required: name, surname, taxCode

ParametersnamerequiredsurnamerequiredtaxCoderequired

docuengine_eventi_negativi_azienda

Direct tool for DocuEngine service: Eventi Negativi Azienda (ID: 69b96f47327b41417c838fb2). [Camerali] Eventi Negativi Azienda 💰 Price: €3.90 📋 Required: reaCode, cciaa

ParameterscciaarequiredreaCoderequired

docuengine_visura_protesti_azienda

Direct tool for DocuEngine service: Visura Protesti Azienda (ID: 69b97173327b41417c838fb3). [Camerali] Visura Protesti Azienda 💰 Price: €0.90 📋 Required: reaCode, cciaa

ParameterscciaarequiredreaCoderequired

docuengine_visura_protesti_e_pregiudizievoli_azienda

Direct tool for DocuEngine service: Visura Protesti E Pregiudizievoli Azienda (ID: 69b97197327b41417c838fb4). [Camerali] Visura Protesti E Pregiudizievoli Azienda 💰 Price: €3.70 📋 Required: reaCode, cciaa

ParameterscciaarequiredreaCoderequired

docuengine_fascicolo_societa_di_capitali

Direct tool for DocuEngine service: Fascicolo Societa' Di Capitali (ID: 69c40e2f327b41417c839015). [Camerali] Fascicolo Societa' Di Capitali 💰 Price: €15.70 📋 Required: taxCode

ParameterstaxCoderequiredprovincecompanyName

docuengine_fascicolo_storico_societa_di_capitali

Direct tool for DocuEngine service: Fascicolo Storico Societa' Di Capitali (ID: 69c40e90327b41417c839018). [Camerali] Fascicolo Storico Societa' Di Capitali 💰 Price: €16.50 📋 Required: taxCode

ParameterstaxCoderequiredprovincecompanyName

docuengine_fascicolo_societa_di_persone

Direct tool for DocuEngine service: Fascicolo Societa' Di Persone (ID: 69c40ebb327b41417c83901a). [Camerali] Fascicolo Societa' Di Persone 💰 Price: €11.70 📋 Required: taxCode

ParameterstaxCoderequiredprovincecompanyName

docuengine_fascicolo_storico_societa_di_persone

Direct tool for DocuEngine service: Fascicolo Storico Societa' Di Persone (ID: 69c40ee0327b41417c83901c). [Camerali] Fascicolo Storico Societa' Di Persone 💰 Price: €11.70 📋 Required: taxCode

ParameterstaxCoderequiredprovincecompanyName

docuengine_durc_online

Direct tool for DocuEngine service: DURC Online (ID: 69c5456840be088d9c41df88). [Camerali] DURC Online 💰 Price: €17.30 📋 Required: companyName, taxCode, legalRepresentativeName, legalRepresentativeTaxCode, pec, phone, legalRepresentativeBirthCountry, document, delegationFile

ParameterspecrequiredphonerequiredtaxCoderequireddocumentrequiredcompanyNamerequireddelegationFilerequiredlegalRepresentativeNamerequiredlegalRepresentativeTaxCoderequiredlegalRepresentativeBirthCountryrequired

docuengine_esponenti_attivi_azienda

Direct tool for DocuEngine service: Esponenti Attivi Azienda (ID: 69cbcb52e9834541b0415e79). [Camerali] Esponenti Attivi Azienda 💰 Price: €2.30 📋 Required: taxCode

ParameterstaxCoderequired

docuengine_cariche_attive_persona

Direct tool for DocuEngine service: Cariche Attive Persona (ID: 69cbccffe9834541b0415e7a). [Camerali] Cariche Attive Persona 💰 Price: €2.10 📋 Required: taxCode

ParameterstaxCoderequired

docuengine_quote_attive_persona

Direct tool for DocuEngine service: Quote Attive Persona (ID: 69cbcd37e9834541b0415e7b). [Camerali] Quote Attive Persona 💰 Price: €2.10 📋 Required: taxCode

ParameterstaxCoderequired

Version history

v0.3.1LatestOct 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 daysRequired25 pts
Auth declaredRequired10 pts
Tools listedRequired15 pts
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts

	Host	Container
Source code	`./src`	`/app/src`
MCP server	`localhost:8080`	`0.0.0.0:8080`
debugpy listener	`localhost:5678`	`0.0.0.0:5678`

Environment	Guide
Local machine (default)	`docs/env/local.md`
Docker / Docker Compose	`docs/env/docker.md`
Google Cloud Platform	`docs/env/gcp.md`
Amazon Web Services	`docs/env/aws.md`
Kubernetes	`docs/env/kubernetes.md`

Openapi®

Overview

Installation

In SourceWeft

Use with an agent

Other MCP clients

README

🔐 Openapi® MCP

The official Python MCP SDK and ready-to-run MCP server for Openapi®

Overview

Environment variables

Core

Storage

Cache

Features

Quick Start — run from PyPI (recommended)

Other runtimes

CLI reference

Running with Docker

Debug and Development

Local development (without Docker)

Remote debugging with VS Code and Docker (one click)

How it works

Workflow

Live code reload

Path mapping reference

Authentication

Option A — Authorization header (recommended)

Option B — ?token= query parameter

MCP Client Configuration (VS Code)

File storage

Default: local filesystem

Cloud storage backends

Deployment environments

Project Structure

Adding New Tools/APIs

Security Notes

Useful Resources

Contributing

Authors

Partners

License

Tools

check_async_status

get_company_IT_full

get_company_IT_advanced

get_company_IT_start

get_company_IT_search

get_company_WW_top

get_company_IT_legal_forms_list

get_company_EU_start

get_company_EU_advanced

get_company_WW_start

get_company_WW_advanced

get_company_FR_search

get_IT_regions_list

get_IT_provinces_list

get_IT_metropolitan_cities_list

get_suppressed_italian_municipalities

find_IT_istat_by_comune_name

find_IT_municipality_by_istat

find_IT_municipalities_by_zip

check_email_start

check_email_advanced

check_mobile_start

check_mobile_advanced

check_ip_advanced

check_url_advanced

get_italian_company_official_documents_list

get_italian_company_official_document

download_italian_company_official_document

send_sms

post_risk_WW_kyc_full

get_risk_IT_creditscore_top

check_IT_fiscal_code

geocode

reverse_geocode

check_license_plate

get_today_exchange_rates

check_pec

Option B — `?token=` query parameter