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