Openapi®

io.github.openapi由 GitHub 帳號 openapi 發布v0.3.1更新於 Oct 30, 2026

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

已驗證Streamable HTTP可網頁執行位置與生活安全與監控商業與電商

服務詳細資訊

識別碼: io.github.openapi/mcp-server
傳輸: Streamable HTTP
執行環境: Web executable
信任: Verified
發布於: Oct 16, 2026

安全提示

MCP 服務會接收對話中的工具呼叫請求，並可能執行外部操作。啟用前請先了解該服務能做什麼，並只授予它所需的權限。

註冊中心已驗證此條目所屬的 GitHub 帳號 openapi。這並不表明該帳號就是產品方。

SourceWeft 的檢查只涵蓋條目是否完整、端點是否回應；不審查伺服器的程式碼，也不審查其工具的行為。

在 README 中新增徽章

向讀者展示該 MCP 服務已收錄於 SourceWeft，徽章連結到本頁。

[![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)

概覽

AI 產生的概覽

Openapi 官方 MCP 伺服器，提供義大利與國際企業資料、PEC、簡訊、車輛、地理編碼、電子郵件與 IP 查核及文件服務。

可以做什麼: 查詢企業資料與財務：依增值稅號或稅號取得義大利、歐盟及全球企業資訊，並支援義大利企業搜尋與法律形式清單
取得義大利登記參考資料：大區、省份、大都會、市鎮、ISTAT 代碼與郵遞區號查詢
執行風險與身分查核：KYC 篩查、義大利信用評分、稅號驗證，以及電子郵件、手機號碼、IP 與網址信譽檢查
發送簡訊並查詢 PEC 認證信箱是否可用
地址地理編碼與反查，以及車牌資訊與每日匯率查詢
申請並下載義大利官方企業文件，列出或追蹤 DocuEngine 服務與請求
適用情境: 適合需要義大利或國際企業登記、財務與風險資料的情境，也適合驗證聯絡方式、地址與車輛資訊。發送簡訊、查詢 PEC 位址或取得義大利官方企業文件的工作流程同樣適用。
執行需求: 可使用 mcp.openapi.com 遠端端點，或在本機以 Python 執行 openapi-mcp-sdk 套件（uvx、pipx 或 pip）。需要於 Openapi 主控台建立 bearer 權杖，依所需權限範圍產生，並透過 Authorization 標頭傳送。自架伺服器需為下載的文件設定本機或 GCS/S3 儲存，並將 MCP_BASE_URL 設為公開位址，下載連結才能正常運作。

安裝前請注意

Authorization bearer 權杖是具權限範圍的付費服務憑證，請勿放入共用設定；README 的 ?token= 網址方式會讓權杖暴露在 URL 中。相關工具會發送簡訊、建立 KYC 請求與訂購官方企業文件，可能產生費用或留下紀錄。電子郵件、手機號碼、IP 與網址檢查會把個人或網路識別資料傳送給第三方。自架伺服器會將請求標頭與參數輸出到標準輸出。

安裝

在 SourceWeft 中

開啟儀表板中的 Openapi®，將其新增到工作區。
連接 Authorization token 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.openapi%2Fmcp-server/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "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.

來源：README.md，提交 0fd4ca5

工具

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

輸入參數request_id必填

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

輸入參數vat_or_taxCode必填

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

輸入參數vat_or_taxCode必填

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

輸入參數vat_or_taxCode必填

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)

輸入參數latpeclongskipcciaalimitdryRunradiusendDatereaCodesdiCodetownCode另有 15 個

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

輸入參數country_code必填vat_or_taxCode必填

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

無需輸入參數。

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)

輸入參數vatCode必填country_code必填

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.)

輸入參數vatCode必填country_code必填

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

輸入參數vatCode必填country_code必填

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

輸入參數vatCode必填country_code必填

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).

輸入參數skiplimitdryRunnafCodecompanyNameprovinceCodeactivityStatusdataEnrichment

get_IT_regions_list

Returns the list of Italian regions

無需輸入參數。

get_IT_provinces_list

Returns the list of Italian provinces

無需輸入參數。

get_IT_metropolitan_cities_list

Returns the list of Italian metropolitan cities

無需輸入參數。

get_suppressed_italian_municipalities

Returns the list of suppressed or merged Italian municipalities

無需輸入參數。

find_IT_istat_by_comune_name

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

輸入參數comune必填

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

輸入參數istatCode必填

find_IT_municipalities_by_zip

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

輸入參數zip_code必填

check_email_start

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

輸入參數email必填

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

輸入參數email必填

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

輸入參數mobile必填

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

輸入參數mobile必填

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

輸入參數ip必填

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

輸入參數url必填

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

輸入參數vat_or_tax_code必填

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

輸入參數document_url必填vat_or_tax_code必填

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.

輸入參數document_id必填document_url必填

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"

輸入參數body必填mobile必填sender必填

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

輸入參數name必填lastName必填firstName必填entityType必填

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

輸入參數vat_or_taxCode必填

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

輸入參數fiscalCode必填

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

輸入參數address必填

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

輸入參數id必填lat必填long必填type必填

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

輸入參數type必填countryCode必填licensePlate必填

get_today_exchange_rates

Obtain daily world exchange rate based on USD value

無需輸入參數。

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

輸入參數pec必填

get_docuengine_services

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

無需輸入參數。

get_docuengine_request_status

Returns the details and status of a specific DocuEngine request.

輸入參數request_id必填

get_docuengine_documents

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

輸入參數request_id必填

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

輸入參數cciaa必填reaCode必填

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

輸入參數cciaa必填reaCode必填

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

輸入參數cciaa必填reaCode必填

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

輸入參數cciaa必填reaCode必填

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

輸入參數cciaa必填reaCode必填

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

輸入參數cciaa必填reaCode必填

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.

輸入參數taxCode必填

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.

輸入參數id必填yearrequest_id必填

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.

輸入參數taxCode必填

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.

輸入參數id必填yearrequest_id必填

docuengine_visura_camerale_inglese

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

輸入參數taxCode必填

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.

輸入參數taxCode必填actGroupCoderequestDateTodocumentDateTorequestDateSincedocumentDateSince

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.

輸入參數id必填yearrequest_id必填

docuengine_statuto

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

輸入參數taxCode必填

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.

輸入參數taxCode必填

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.

輸入參數id必填yearrequest_id必填

docuengine_certificato_di_iscrizione

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

輸入參數phonetaxCode必填shippingAddressshipmentRecipient

docuengine_certificato_artigiano

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

輸入參數phonetaxCode必填shippingAddressshipmentRecipient

docuengine_certificato_storico

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

輸入參數phonetaxCode必填shippingAddressshipmentRecipient

docuengine_soci_attivi_azienda

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

輸入參數taxCode必填

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

輸入參數name必填surname必填taxCode必填

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

輸入參數name必填surname必填taxCode必填

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

輸入參數name必填surname必填taxCode必填

docuengine_eventi_negativi_azienda

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

輸入參數cciaa必填reaCode必填

docuengine_visura_protesti_azienda

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

輸入參數cciaa必填reaCode必填

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

輸入參數cciaa必填reaCode必填

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

輸入參數taxCode必填provincecompanyName

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

輸入參數taxCode必填provincecompanyName

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

輸入參數taxCode必填provincecompanyName

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

輸入參數taxCode必填provincecompanyName

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

輸入參數pec必填phone必填taxCode必填document必填companyName必填delegationFile必填legalRepresentativeName必填legalRepresentativeTaxCode必填legalRepresentativeBirthCountry必填

docuengine_esponenti_attivi_azienda

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

輸入參數taxCode必填

docuengine_cariche_attive_persona

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

輸入參數taxCode必填

docuengine_quote_attive_persona

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

輸入參數taxCode必填

版本歷史

v0.3.1最新Oct 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

近 30 天內可連通必需25 分
已宣告認證方式必需10 分
已列出工具必需15 分
描述必需15 分
圖示10 分
文件15 分
授權條款10 分

	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®

概覽

安裝

在 SourceWeft 中

交給代理程式安裝

其他 MCP 客戶端

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

工具

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