Connect Openapi.com to ChatGPT via MCP

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Openapi.com Company, paste your credentials, mint an MCP API key and you're done. No Docker, no git clone, no local server.

Openapi.com Company + ChatGPT

Italian and international company data from Openapi.com by VAT number or tax code: company profile at three levels, PEC, SDI code, address, shareholders, stakeholders, beneficial owners, cessation and VAT-group checks, public administrations, split payment, company search, EU VIES checks and worldwide lookups. Read-only; every call is billed per request by Openapi.com.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

OPENAPI_COMPANY_TOKEN

Step 1 — Get credentials

Setup takes a few minutes. You need an Openapi.com account on console.openapi.com with credit in its wallet or a Company API subscription, and a token with the Company scopes.

1. Sign in at console.openapi.com and top up credit or subscribe to the Company API.
2. Create a token with the Company scopes you need, in the console's Tokens section or with the OAuth API. A scope names the endpoint, e.g. GET:company.openapi.com/IT-advanced for openapi_company_it_advanced. One token can carry several scopes and is valid for up to a year.
3. Copy the token into OPENAPI_COMPANY_TOKEN: only the token, without Bearer. The connector sends it as Authorization: Bearer ....
4. Install the connector. To check the connection, look up a VAT number you know with openapi_company_it_start; that call is billed like any other.

Every call is billed: Openapi.com charges each request to your account, from wallet credit or your subscription, at the price per endpoint shown on console.openapi.com. No tool is free. openapi_company_it_full is the most expensive call of the API; openapi_company_it_search is priced by the number of results and the data enrichment you ask for. The AI picks the cheapest tool that answers (openapi_company_it_start or openapi_company_it_name before openapi_company_it_advanced, openapi_company_it_advanced before openapi_company_it_full), does not repeat a lookup it already has, and runs a search with dryRun 1 first: that returns the number of matches and the price, which the AI tells you before the real search.

Scopes decide what works: a call to an endpoint the token has no scope for answers 403. In that case create a token with the GET:company.openapi.com scopes you need.

Production, or the sandbox to try it out: the connector calls production at https://company.openapi.com. Openapi.com also runs a sandbox at https://test.company.openapi.com with its own sandbox tokens and a fixed list of test companies. To try it, change the connector's base URL to the sandbox address and use a sandbox token. A sandbox token on production answers 401.

Cloud and self-hosted work the same way: the token is the only credential, and the connector calls the same Openapi.com address from both.

Which countries: Italy in depth, from the chamber of commerce, the Revenue Agency and the IPA index of public administrations. For other EU countries, openapi_company_eu_vies_check checks a VAT number in VIES and openapi_company_eu_start returns basic data for the prefixes AT, BE, BG, CY, CZ, DE, DK, EE, EL, ES, FI, FR, GB, HR, HU, IE, IT, LT, LU, LV, MT, NL, PL, PT, RO, SE, SI and SK. openapi_company_ww_start and openapi_company_ww_advanced cover companies in any country, with advanced data where that country's sources provide it. The country-specific FR, DE, ES, PT, GB, BE, AT, CH and PL endpoints of Openapi.com are not included: the worldwide tools stand in for them.

Identifiers: an Italian VAT number (partita IVA) has 11 digits (12485671007), a company's tax code (codice fiscale) is usually the same 11 digits, a sole trader's tax code has 16 characters. Answers also carry an Openapi id that most Italian tools accept instead. openapi_company_eu_vies_check takes the country code separately (EL for Greece), openapi_company_eu_start takes it as a prefix (DE123456789), and the worldwide tools take an ISO two-letter country code with a VAT number, tax code, company number or Openapi id.

Company search: openapi_company_it_search filters by name (at least 3 characters, * as wildcard), province, town, ATECO code, legal form (codes from openapi_company_it_legal_forms), chamber of commerce status, turnover, employees, shareholder, PEC, SDI code or a radius around a point. Without dataEnrichment it returns only ids; with it, company data billed per result. At most 1000 results per call; page with skip and limit.

Slow sources: when the registries are slow, a heavy call such as openapi_company_it_full or openapi_company_it_stakeholders answers after 30 seconds with a request id and the state PENDING. The AI then calls openapi_company_check_request with that id a little later instead of paying for the lookup again.

Not included: the asynchronous POST variants with callbacks, the AML and marketing packages and change monitoring (/monitor).

Common errors: a failed call carries success: false, an error code and a message. 401 means the token is missing, wrong or expired, or is a sandbox token used on production. 402 means the account has no credit left for that call: top up on console.openapi.com. 403 means the token lacks the scope for that endpoint. 404 means no company was found, 406 a malformed VAT number or tax code. 429 means too many requests, or that the national VIES registry is busy: wait a moment and try again.

What it reads: for Italian companies, name, VAT number, tax code, address and activity status; ATECO code, legal form, REA number, share capital, turnover and employees from the latest balance sheets, and registration and cessation dates; the complete file with managers and over 400 balance-sheet figures; the PEC with its history and the SDI code for e-invoices; shareholders above 10 percent, stakeholders, the companies it holds stakes in, and beneficial owners; whether a VAT number has ceased, whether a company belongs to a VAT group and whether it is on the split-payment lists; public administrations with their IPA offices and SDI codes; the legal-form codes. For other countries: VIES validity with name and address, and basic or advanced company data worldwide.

Read-only: every tool only reads. Nothing is written to Openapi.com or to any registry, so no tool is switched off at install; every call is still billed.

Step 2 — Install the adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Add the connector in ChatGPT

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

ChatGPT adds MCP servers as plugins on its Plugins page, on the web and on paid plans. Developer mode is no longer needed. In a Business workspace only admins and owners can add one; in Enterprise and Edu an admin can grant the Create plugins with MCPs permission.

1. Go to chatgpt.com/plugins, click Add, then Add custom MCP server.
2. Enter a name, e.g. Name: Openapi.com Company.
3. Under Connection, enter the Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID and keep Authentication on OAuth.
4. Select I understand and want to continue, then Create as a plugin. When ChatGPT asks, sign in to AnythingMCP and allow access.
5. Install the new plugin from your personal plugins, then type @ in a chat and pick it.

Available tools

Example prompts

• "Check VAT number 12485671007 before I invoice it: company name, whether it is still active, SDI code and PEC."
• "Who are the shareholders and the beneficial owners of the company with VAT number 12485671007?"
• "Before I invoice this public body, check whether it is on the split-payment lists and give me the SDI codes of its offices."
• "How many active companies with ATECO code 62.01.00 are there in the province of Milan? Tell me the price before you run the search."
• "Is the German VAT number DE123456789 valid in VIES, and which company name is registered for it?"

FAQ

Does the free ChatGPT plan work with custom MCP servers? OpenAI documents custom MCP servers for paid plans only; the Free plan is not on its list.

Next steps

• Connector landing page
• Connect to Claude