Global Database README
The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Global Database listing page.
Global Database — MCP Server
Remote MCP server that gives LLM agents access to Global Database: company profiles, financials, ownership, digital insights, people search and contact enrichment, prospecting, and KYB/compliance lookups against official government registries.
Hosted at https://mcp.globaldatabase.com/mcp (Streamable HTTP). Nothing to install
or run — you connect to it and sign in with your Global Database API key through the
browser.
Install
Cursor
Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project):
Claude Code
Or install the plugin, which adds the server and three skills (company-due-diligence,
company-snapshot, prospect-list):
VS Code (GitHub Copilot)
Use the Install server badge above, or add it from the terminal:
To commit it for a whole repository instead, put this in .vscode/mcp.json — the copy in
this repo is exactly that file, so cloning it and opening the folder in VS Code offers the
server without any further setup:
Note the key is servers, not mcpServers. VS Code differs from Claude Code and Cursor
here, the same way Gemini CLI expects httpUrl and Antigravity expects serverUrl for the
identical endpoint. Copying the wrong file between clients produces a config that loads
without error and connects to nothing.
A user-level equivalent exists too — run MCP: Open User Configuration from the Command
Palette (it lives under the VS Code user profile, not ~/.copilot/mcp-config.json — that
path belongs to the separate GitHub Copilot CLI and expects mcpServers, not servers).
Signing in is a browser OAuth flow on first use; there is nothing to paste into the config.
Gemini CLI
Install the bundled extension straight from this repo:
Or add the server to settings.json by hand:
Perplexity
Requires a paid plan (custom connectors are a Pro/Enterprise feature). In Settings → Connectors → + Custom connector → Remote, enter:
| Field | Value |
|---|---|
| Name | Global Database |
| MCP Server URL | https://mcp.globaldatabase.com/mcp |
| Authentication | OAuth |
| Transport | Streamable HTTP |
Then open the connector card to run the OAuth sign-in.
Grok
At grok.com/connectors → New Connector → Custom, enter the
MCP server URL https://mcp.globaldatabase.com/mcp and complete the OAuth sign-in. Grok
discovers the tools from the live endpoint.
Microsoft Copilot Studio
In your agent → Tools → Add a tool → Model Context Protocol → New MCP server, enter the
server URL https://mcp.globaldatabase.com/mcp and pick OAuth 2.0 with dynamic
registration / discovery. Leave Scope empty — the server publishes no scopes, and a
non-empty one fails the token request.
Copilot Studio ignores the MCP instructions field, so the agent starts without the routing
rules every other client receives. Paste
copilot-studio-instructions.md into Agent → Overview →
Instructions after the connection is created.
Claude.ai / other MCP clients
Add a custom connector pointing at https://mcp.globaldatabase.com/mcp.
Authentication
OAuth 2.1 with PKCE and Dynamic Client Registration — the client registers itself, so there is nothing to configure. On first connect your browser opens a Global Database login page where you paste your API key; the key is held in the access-token claims server-side and is never passed as a tool argument.
Get an API key at globaldatabase.com.
Tools
| Tool | What it does |
|---|---|
check_api_key | Verify the API connection and return current user info. |
get_company_by_website | Look up a company by website URL or domain. |
get_company_by_linkedin | Look up a company by LinkedIn URL or public ID. |
get_company_by_identifiers | Look up a company by name, registration number, VAT, ticker, website, email, or LinkedIn. |
get_company_details | Full company profile by company_id. |
get_company_financials | Balance sheet, ratios, and key metrics per year. |
get_company_ownership | Shareholders and corporate group structure. |
get_digital_insights | Web traffic, rankings, traffic sources, WHOIS, technologies. |
search_employees | Find the people at a company, or people by name, role, department, or seniority. |
get_employee_details | Full profile for one person from a search_employees row. |
find_people_by_domain | Find people at companies given by web domain, via the contact-enrichment providers. |
enrich_employee_contacts | Find and enrich one named employee/contact — email, phone, socials. |
get_nomenclature | Lookup values for use with prospecting filters. |
prospecting | Search and filter companies by country, industry, size, revenue, and more. |
kyb_search | Search official government registries for KYB/compliance checks. |
kyb_company_details | Official registry details for a company. |
kyb_officers | Directors, secretaries, and officers from the official registry. |
kyb_shareholders | Shareholders from the official registry. |
kyb_shareholders_search | Reverse shareholder lookup by holder name, across jurisdictions. |
kyb_group_structure | Corporate group structure from the official registry. |
kyb_financial | Detailed financial statements across multiple years. |
kyb_officers_search | Reverse officer lookup by person's name, across jurisdictions. |
Resources and prompts
Beyond tools, the server exposes MCP resources so a client can load reference data once per conversation instead of spending a tool call (and credits) on it:
| Resource | Contents |
|---|---|
gdb://nomenclature/country | Country list for the prospecting location filter. |
gdb://nomenclature/kyb-countries | Country list for kyb_search. |
gdb://nomenclature/company-status | Company status values for prospecting. |
gdb://nomenclature/department | Department ids for search_employees. |
gdb://nomenclature/seniority | Seniority ids for search_employees. |
gdb://docs/prospecting-filters | Full prospecting filter catalog — field names and value formats. |
gdb://docs/intent-glossary | Keyword → tool glossary for routing a request. |
Larger, hierarchical nomenclatures (NACE, ISIC, SIC, industry focus, region) stay behind the
get_nomenclature tool and its search parameter.
Prompts shipped with the server: company_research, due_diligence, lead_generation,
competitor_analysis, market_research.
Plugins and skill
The same contents ship as a plugin for both Cursor (.cursor-plugin/plugin.json) and
Claude Code (.claude-plugin/marketplace.json), so the server can be installed from a
marketplace instead of being wired up by hand. Each plugin bundles:
- the remote MCP server above (all tools), and
- three skills:
company-due-diligencewalks the agent through a structured KYB review — resolve the entity, then pull registry details, officers, shareholders, group structure and financials into one dossier;company-snapshotgives a fast one-screen profile instead of the full dossier;prospect-listbuilds a target account list from firmographic filters, optionally enriched with contacts.
Where it is listed
Verified 2026-09-01.
| Directory | Entry |
|---|---|
| Official MCP Registry | com.globaldatabase/mcp — published from server.json |
| Claude Connectors Directory | global-database — Community tier |
| Claude Plugin Directory | global-database — submitted 2026-09-01, pending review. Ships the MCP server plus three skills |
| OpenAI ChatGPT | Global Database — Apps SDK app |
| Smithery | global-database |
| Glama | com.globaldatabase/mcp |
| Cursor Directory | mcp-global-database-3 |
| mcptop.com | openai-global-database — third-party leaderboard |
Also installable without a directory:
| Channel | How |
|---|---|
| Claude Code plugins | /plugin marketplace add global-database/mcp-server |
| Antigravity CLI | agy plugin install against this repo |
| Gemini Enterprise | admin registers it as a custom MCP connection per tenant |
Not listed: PulseMCP (their submissions are paused), mcp.so, and the VS Code / GitHub MCP
gallery — that last one is a curated catalogue of a few hundred servers and is not an
ingest of the Official MCP Registry, so publishing there does not reach it. Also not
pursued: Perplexity's curated connector catalog (no self-serve submission exists — only the
custom-connector route above) and Microsoft's MCP server certification for Copilot Studio (a
real Partner Center pipeline, unlike Perplexity's — see PUBLISHING.md).
Maintainer notes — publishing, DNS verification and the remaining directories:
PUBLISHING.md.
Links
About this repository
Distribution metadata only (server.json, .mcp.json, plugin.json,
.claude-plugin/, .cursor-plugin/, gemini-extension.json) so MCP directories and
clients can discover the hosted server, plus the client-side extras that ship with it — the
three skills and the Copilot Studio instruction block. MIT covers this
metadata; the server implementation and the Global Database API are not open source.