Model Context Protocol · Developer Reference

GlobalData Intelligence Center MCP

A governed MCP server that turns GlobalData's business intelligence across 23 industry verticals into tools an AI agent can call directly — no bespoke API integration, no SQL, no data export.

Section 01

What the GlobalData Intelligence Center MCP is

A single MCP server endpoint per vertical that exposes structured business intelligence as callable tools. Your AI agent resolves taxonomy, queries live data, and receives structured responses — without custom ETL pipelines or direct database access.

One gateway, 23 verticals

A single endpoint pattern: https://mcp.globaldata.com/{site}/mcp. Disruptor, Technology, Mining, Construction, Power, Oil & Gas, Financial Services, Consumer, and more — each reachable through the same MCP connection with the same tool interface. Three of the 23 (Strategic Intelligence, Celent Intelligence, Stylus) expose a narrow, dedicated domain set rather than the full platform surface — see Section 07.

Resolve, then search

The gateway normalises plain-English terms — industries, locations, themes, deal types, company names — to GlobalData's canonical taxonomy before querying, so filters match the catalog and results are accurate.

Client-agnostic

Any compliant MCP client: Claude Desktop, claude.ai connectors, OpenAI Agents / Responses API, Microsoft Copilot Studio, and custom agents built on the MCP SDK.

Section 02

How a query flows through the platform

Every agent interaction follows a four-stage pipeline from authentication through to structured results.

Step 1

Connect

initialize

Authenticate via GlobalData SSO and open the MCP session over Streamable HTTP.

Step 2

Discover

discover_capabilities

Reveal the tools for the vertical and domain you need. Progressive — tools appear on demand.

Step 3

Resolve

resolve_entities

Map plain-English terms to canonical taxonomy values with confidence scores.

Step 4

Search

search / list_*

Run the query with resolved filters. Paginate and chain results by Company ID across domains.

3-tier platform architecture

Client
AI Agent
Any MCP-compliant client
ClaudeOpenAICopilotCustom
➞
Tier 1
MCPGateway
SSO Auth · Routing · Session state · Tool registry
Streamable HTTP23 verticals
➞
Tier 2
CommonContent MCP Server
Tool execution · Entity resolver · ES query builder · Reachable only via the Gateway
BM25 + KNN63 domains
➞
Tier 3
Data Layer
6 ElasticSearch clusters · SQL · Market data APIs
CompaniesDealsNews+11

Company ID anchors a query

Company ID (returned by list_companies, and by resolve_entities as company_id) is the primary join key across all content domains. Use it for "for this company, give me…" multi-domain queries that chain deals, news, filings, jobs, and patents. A second identifier, cdms_company_id, is also returned alongside it — it's a different ID system used only by a handful of specific tools that ask for it by name; use company_id everywhere else.

Use search when unsure

The search facade resolves entities, routes to the right tool by intent, and returns data plus delegated_tool, route, and applied_filters. No domain reveal needed before calling it.

3-tier architectureMCPGateway (authentication, routing, session state) → CommonContentMCPServer (tool execution, entity resolution, ElasticSearch queries) → 6 ElasticSearch clusters + SQL databases.
Internal zero-trust boundaryTier 2 only accepts traffic that has already been authenticated by the Gateway — it cannot be reached directly from the public internet. You never see or manage this; it's transparent to every client flow described in this document.
Section 03

Progressive discovery

The gateway doesn't expose all tools at connect time. A small entry layer is always visible; each domain's tools appear only when you call discover_capabilities. This keeps the agent's tool list focused and avoids overwhelming it with irrelevant capabilities.

Level 0 · Always on
list_domains  ·  search  ·  resolve_entities  ·  discover_capabilities  ·  reveal_advanced  ·  get_capabilities  ·  tool_search
No unlock needed
Level 1 · Standard tools
list_companies  ·  list_deals  ·  list_newsarticles  ·  list_filing  ·  list_patents  ·  list_jobs  ·  list_reports  ·  ···
discover_capabilities('domain')
Level 2 · Analytics
get_company_analytics  ·  get_deals_analytics  ·  get_news_analytics  ·  get_jobs_analytics  ·  get_filings_analytics  ·  ···
reveal_advanced('domain')
Level 0

Always on

Available the moment you connect, no unlock needed.

  • list_domains
  • search
  • resolve_entities
  • discover_capabilities
  • reveal_advanced
  • get_capabilities
  • tool_search
Level 1

On request — Standard

Revealed per session via discover_capabilities('domain').

  • list_companies
  • list_deals
  • list_newsarticles
  • list_filing
  • list_patents
  • list_jobs
  • list_reports and more…
Level 2

On request — Advanced

Revealed via reveal_advanced('domain') alongside the standard set.

  • get_company_analytics
  • get_deals_analytics
  • get_news_analytics
  • get_jobs_analytics
  • get_filings_analytics
  • …and more per domain
Calling discover_capabilities or reveal_advanced emits a notifications/tools/list_changed event — compliant clients re-fetch the tool list automatically. The search facade routes to any tool, revealed or not.
Revealed ≠ safe to call by name immediatelyTool visibility is now driven primarily by what your subscription actually includes, not by a reveal step alone — so a domain you're entitled to is usually usable right away. But your client's own local tool list still needs to catch up before it will let you call a tool by name, and not every client refreshes that automatically. Right after revealing a domain, call search(domain="...", keywords="...") for guaranteed access (parameter renamed from query to keywords — query still works as a legacy alias), or call tools/list again and only call a tool by name once it actually appears in the response. Calling a freshly-revealed tool by name before that can fail with a "tool not found" error — and if the domain isn't in your subscription at all, discover_capabilities/reveal_advanced will now say so directly instead of pretending to reveal it.
Section 04

Authentication

All authentication flows through GlobalData SSO at login.globaldata.com. Two flows are supported: credentials-based (for server-to-server agents and scripts) and OAuth 2.1 Authorization Code + PKCE (for interactive clients such as claude.ai and Copilot Studio).

Exchange GlobalData username and password for a bearer token. Best for back-end agents, scripts, and server-to-server automation.

Request — cURL
POST https://login.globaldata.com/oauth/token
Content-Type: application/x-www-form-urlencoded

grant_type=password
&username=$GD_USERNAME
&password=$GD_PASSWORD
&scope=openid profile email offline_access
Response
{
  "access_token": "eyJ...",
  "token_type":   "Bearer",
  "expires_in":   3600
}

Pass the token on every MCP request: Authorization: Bearer eyJ...

Authorization Code flow with PKCE — used by claude.ai connectors, Copilot Studio, and browser-based clients. The user signs in via a browser window; no client secret is stored in the agent.

  • Authorization server: https://login.globaldata.com
  • Sign-in options: GlobalData username/password · Microsoft Entra ID · Google Workspace · Okta / enterprise SSO
  • Redirect URI must be registered with the DDS team before use
  • Token endpoint: https://login.globaldata.com/oauth/token
  • OAuth server metadata: https://login.globaldata.com/.well-known/oauth-authorization-server

When using mcp-remote (Claude Desktop), a browser window for GlobalData SSO sign-in opens automatically on first connect.

For service identities with no human behind them — backend jobs, scheduled pipelines, server-to-server integrations. Unlike the password grant, no GlobalData user account is involved and access is scoped per service account rather than per person. Tokens are minted directly by the Gateway's own /token endpoint — this grant is not proxied to login.globaldata.com like the other two flows.

Two credential types, chosen per service account when it's provisioned:

  • Private key JWT (RFC 7523) — sign a short-lived JWT assertion with your service account's private key and present it as client_assertion. No secret ever crosses the wire.
  • Client secret (RFC 6749 client_secret_post) — present client_id + client_secret directly. Simpler, but the secret is a bearer credential — store and rotate it accordingly.
Request — client_secret tier
POST https://mcp.globaldata.com/token
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials
&client_id=$GD_SERVICE_CLIENT_ID
&client_secret=$GD_SERVICE_CLIENT_SECRET
&scope=mcp.read
Request — private_key_jwt tier
POST https://mcp.globaldata.com/token
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials
&client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer
&client_assertion=$SIGNED_JWT_ASSERTION
&scope=mcp.read
Response
{
  "access_token": "eyJ...",
  "token_type":   "Bearer",
  "expires_in":   900,
  "scope":        "mcp.read"
}

Access tokens default to a 900-second lifetime — request a new one per job run rather than caching long-term. Discovery metadata at /.well-known/oauth-authorization-server (and signing keys at /.well-known/jwks.json) only advertises client_credentials and private_key_jwt once M2M is enabled for your environment.

ProvisioningService accounts (client ID, credential type, granted scopes) are provisioned by the GlobalData platform team — contact us to request one rather than generating credentials yourself.
Keep credentials secretStore usernames, passwords, secrets, and tokens in environment variables or a secrets manager. Never embed them in client-side code, committed config files, or chat messages.
Section 05

Connect your MCP client

Replace {site} with your vertical slug (e.g. disruptor, construction, mining). The full slug list is in Section 07.

Edit the Claude Desktop config: Settings → Developer → Edit Config.

claude_desktop_config.json
{
  "mcpServers": {
    "GlobalData-MCP": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.globaldata.com/{site}/mcp"
      ]
    }
  }
}

mcp-remote opens a browser window for GlobalData SSO sign-in on first connect. Subsequent sessions reuse the cached token. Restart Claude Desktop to pick up new tools after a tool set change.

  1. Go to Settings → Connectors → Add custom connector
  2. Paste the endpoint: https://mcp.globaldata.com/{site}/mcp
  3. Click Connect and sign in via GlobalData SSO
  4. Enable the connector in your chat conversation
  5. Call list_domains to verify the connection is working
JavaScript — OpenAI Responses API
const response = await client.responses.create({
  model: "gpt-4.1",
  input: "List GlobalData domains, then find tech deals in APAC.",
  tools: [{
    type:             "mcp",
    server_label:     "gd_mcp",
    server_url:       "https://mcp.globaldata.com/disruptor/mcp",
    headers:          { "Authorization": `Bearer ${process.env.GD_ACCESS_TOKEN}` },
    require_approval: "never"
  }]
});
Requires a publicly resolvable HTTPS URL. Obtain an access token via the credentials flow first and pass it in the headers object.
  1. Open your agent → Tools → Add a tool → Model Context Protocol
  2. Provide server URL: https://mcp.globaldata.com/{site}/mcp and a display name
  3. Authentication: select OAuth 2.0 and paste the GlobalData token URL and client credentials, or use Entra ID for signed-in users
  4. Save and publish the agent. Re-sync and re-publish to pick up new tools.
cURL — list entry tools
curl -N https://mcp.globaldata.com/disruptor/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer $GD_ACCESS_TOKEN" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Streamable HTTP transport. POST JSON-RPC 2.0 payloads to /{site}/mcp.

Section 06

Gateway & discovery tools

These seven tools are always available the moment you connect — no domain reveal required. They orient your agent, resolve taxonomy terms, route queries, and unlock domain-specific tools.

list_domains

Lists all available domains for your vertical with their unlock status and the exact command to reveal each one. Your agent's starting point — call this first to understand what data is accessible before deciding which domains to unlock.

discover_capabilities

Reveals a domain's standard tools for this session. For example, discover_capabilities('companies') makes list_companies and get_company_descriptions callable. Emits notifications/tools/list_changed so compliant clients refresh automatically.

reveal_advanced

Reveals a domain's analytics tools alongside its standard set. For example, reveal_advanced('companies') additionally exposes get_company_analytics. Use when you need aggregation, trend analysis, or market-level summaries.

get_capabilities

Returns the full domain and tool catalog without revealing or enabling anything. Use to inspect what tools exist across all domains before deciding what to unlock — useful for planning a multi-step query sequence.

tool_search

Searches all tools by keyword across all domains and returns names and summaries even before they are revealed. Use when you know the data type you want (e.g. "analytics", "patent", "project") but aren't sure which domain or tool name to use.

search

Universal entry point: accepts a natural-language query and optional filters, resolves entities internally, routes to the right tool by intent, and returns data plus delegated_tool, route, and applied_filters. Use when unsure which specific tool fits — dispatches to any tool, revealed or not.

resolve_entities

Maps free-text terms (industry, location, theme, deal type, sentiment, and more) to canonical GlobalData taxonomy values with a confidence score (0–1). Call before any direct list_* tool to ensure filters match the catalog. Free-text fields like companyName and keyword pass through unchanged.

Section 07

Verticals & domains explorer

23 industry verticals, each with its own endpoint. 20 share a common content bundle plus their own vertical-specific domains; 3 (Strategic Intelligence, Celent Intelligence, Stylus) are narrow, single-purpose verticals with no common-bundle access at all. Expand a domain to see its tools, or search by tool name.

Intelligence Centers

Intelligence CenterNotes
Consumer Intelligence CenterAdds: pldb, pla, ingredients, packtrack, pricing domains
Retail Intelligence Center
Packaging Intelligence CenterAdds: pla, ingredients, packtrack, pricing domains
ADS Intelligence CenterAdds: defence_projects domain
Financial Services Intelligence Center
Technology Intelligence CenterAdds: ict_contracts, ict_client_prospector, partner_network_database domains
Disruptor Intelligence CenterAdds: innovation_explorer, ict_client_prospector domains
Mining Intelligence CenterAdds: mine_projects, mining_cost_curve domains
Oil and Gas Intelligence CenterAdds: upstream, midstream, downstream, oilgas_energy_transition, equipment_and_services, operation_metrics, pla, ingredients, packtrack, pricing domains
Power Intelligence CenterAdds: power_plants, tenders_and_contracts, auctions, td_projects, td_interconnection_projects, td_system_operators, td_investment, energy_storage_projects, smart_grid_projects, power_energy_transition, equipment_markets domains
Construction Intelligence CenterAdds: construction_project_contacts, innovation, construction_projects, construction_tenders domains
Insurance Intelligence CenterAdds: innovation_explorer, regulatory_updates domains
Automotive Intelligence Center
Travel & Tourism Intelligence Center
Foodservice Intelligence CenterAdds: menu_intelligence domain
Apparel and Footwear Intelligence Center
MEED ProjectsRestricted vertical — exclusively meed_projects, meed_companies, meed_contacts, meed_project_analysis, plus news. Does not receive the common content bundle or Construction's project/contact domains.
Sport Intelligence CenterAdds: sports_athletes, sports_venues, sports_competitions, sports_conferences, sports_deals, sports_brands, stadium_projects, sports_media_revenues domains
GlobalData Explorer
Agribusiness Intelligence Center
Strategic Intelligence RestrictedExclusively reports and theme_scorecards. No common content bundle.
Celent Intelligence RestrictedExclusively reports. No common content bundle, no other domains.
Stylus RestrictedExclusively stylus_reports. No common content bundle, no other domains.
The fdi_projects and global_ads domains (list_fdiprojects, list_globalads) are available on every one of the 20 ordinary verticals above — neither is tied to a single Intelligence Center. theme_scorecards, themes_map, and surveys are likewise part of the common bundle on those 20, but are not available on MEED Projects, Strategic Intelligence, Celent Intelligence, or Stylus, whose domain access is restricted to the short lists above.

Domain explorer

companies

list_companies▼
Standard tools
list_companiesStandard

Search and list companies by name, industry, type, headquarters country, revenue range, or keyword. Returns structured company records including Company ID — the primary join key used to retrieve related deals, news, filings, jobs, and patents for that company across all content domains.

get_company_descriptionsStandard

Retrieve full company profiles for one or more Company IDs: overview text, financials (revenue, net income, EBITDA, employee count), trading information, parent/subsidiary relationships, sector classification, and contact details.

Advanced tools
get_company_analyticsAdvanced

Aggregate company data into buckets for quantitative analysis. Group by industry, country, revenue band, or financial year. Returns counts and metric summaries (revenue, net income, market cap, employee count, growth rates). Requires reveal_advanced('companies').

deals

list_deals▼
Standard tools
list_dealsStandard

Search M&A transactions, licensing agreements, partnerships, and collaborations. Filter by deal type, status, rationale, geography, company name, or date range. Returns deal summaries including parties, deal value, and deal date.

get_deals_descriptionsStandard

Full deal profiles for one or more Deal IDs: description, all parties involved, disclosed financials, deal rationale, advisors, investors, and related company and industry tags.

Advanced tools
get_deals_analyticsAdvanced

Aggregate deal data for market-level analysis. Group by deal type, status, year, geography, industry, or theme. Returns counts and total/average deal values. Requires reveal_advanced('deals').

news

list_newsarticles▼
Standard tools
list_newsarticlesStandard

Search curated news articles by company name, industry, theme, news category, sentiment (Positive / Negative / Neutral), location, or date range. Returns article summaries with sentiment scores and tagged entities.

get_newsarticle_descriptionsStandard

Full article content for one or more article IDs: headline, body text, publication date, source, sentiment score, mentioned companies, industries, and themes.

Advanced tools
get_news_analyticsAdvanced

Aggregate news volume and sentiment over time. Group by company, industry, month, or theme to surface coverage trends and sentiment shifts. Requires reveal_advanced('news').

filings

list_filing▼
Standard tools
list_filingStandard

Search regulatory and corporate filings — annual reports, quarterly reports, earnings call transcripts, investor presentations — by company, filing type, sector, country, or date.

get_filingsentencesStandard

Extract specific sentences or passages from a filing document by keyword or topic. Ideal for surfacing ESG disclosures, risk factors, or forward-looking statements without reading the full document.

get_filing_documentStandard

Returns the full structured filing document broken into labelled sections, making it easy to navigate directly to a specific part of the filing.

get_filing_document_textStandard

Returns the raw full text of a filing. Documents are stored in cloud storage; a time-limited access URL is returned for download or further processing.

Advanced tools
get_filings_analyticsAdvanced

Aggregate filing volume and sentiment by filing type, sector, country, or year. Requires reveal_advanced('filings').

patents

list_patents▼
Standard tools
list_patentsStandard

Search patents by IPC classification code, application year, assignee company, inventor country, or keyword. Returns patent summaries including application number, title, assignee, and filing and grant dates.

get_patent_descriptionsStandard

Full patent record for one or more patent IDs: abstract, full IPC classification tree, inventor list, applicant/assignee details, filing date, and grant status.

jobs

list_jobs▼
Standard tools
list_jobsStandard

Search job postings by title, occupation category, seniority level, company name, country, state/city, or posting date. Returns postings with salary ranges (local currency and USD-normalised) and required education/skills.

get_job_descriptionsStandard

Full job posting content for one or more job IDs: full description text, salary min/max, education requirements, occupation classification, and skills tags.

Advanced tools
get_jobs_analyticsAdvanced

Aggregate job posting data for hiring trend analysis. Group by occupation, country, company, education type, or date. Returns counts and salary analytics (min, max, median). Requires reveal_advanced('jobs').

get_jobs_analytics_multi_viewAdvanced

Fetches multiple jobs analytics groupings simultaneously (e.g. occupation + location + education) in one call, reducing round trips for dashboard-style queries. Requires reveal_advanced('jobs').

construction_project_contacts (formerly the shared "contacts" domain)

list_contactsconstruction only▼
Available on: construction (site 63) only. MEED Projects no longer shares this domain — it has its own meed_contacts domain instead (see the MEED Projects block below). Requires a contacts entitlement — contact the DDS team if access is denied.
Standard tools
list_contactsStandard

Search decision-maker and senior professional contacts at tracked companies. Filter by name, job title, department, company name, or country. Returns contact profiles with verified business contact details.

reports

list_reports▼
Standard tools
list_reportsStandard

Search GlobalData analyst research reports including market forecasts, sector analyses, country intelligence reports, and thematic studies. Filter by topic, industry, country, or publication date.

get_report_descriptionsStandard

Full report details for one or more report IDs: abstract, key findings summary, scope, methodology overview, lead analyst, and publication date.

social

list_socialmediaposts▼
Standard tools
list_socialmediapostsStandard

Search social media posts that mention tracked companies, industries, or themes. Filter by sentiment, company, industry, or date range. Returns post summaries with sentiment scores and entity tags.

buying_signals (renamed from leads)

list_buying_signals▼
Standard tools
list_buying_signalsStandard

Retrieve actionable sales lead records: BD-relevant events classified by supplier relevance. Sources include deal announcements, hiring signals, regulatory events, and news triggers. Filter by lead type, industry, company, or date.

Advanced tools
get_buying_signals_analyticsAdvanced

Aggregate buying signal volume by signal/lead type, company, or month. Requires reveal_advanced('buying_signals').

theme_scorecards

list_theme_scorecards▼
Part of the common content bundle on the 20 ordinary verticals. Also one of only two domains available on strategicintelligence (site 109) — see that vertical's restricted scope in the table above. Not available on celentintelligence, stylus, or meedprojects.
Standard tools
list_theme_scorecardsStandard

Search thematic scorecard records — GlobalData's theme-level scoring and ranking data across companies, sectors, or countries.

themes_map

list_themesmap▼
Part of the common content bundle on the 20 ordinary verticals. Not available on strategicintelligence, celentintelligence, stylus, or meedprojects — their domain access is restricted to the short lists in the table above and does not include this domain.
Standard tools
list_themesmapStandard

Search theme-to-company/sector mapping records — which companies and sectors are tagged against which GlobalData themes.

surveys

list_surveys▼
Part of the common content bundle on the 20 ordinary verticals. Not available on strategicintelligence, celentintelligence, stylus, or meedprojects.
Standard tools
list_surveysStandard

Search consumer/industry survey and poll records by topic, geography, or date.

list_survey_questionsStandard

List the individual questions asked within a specific survey.

get_survey_question_descriptionsStandard

Full detail for one or more survey questions, including response options.

Advanced tools
get_survey_demographic_filtersAdvanced

Discover which demographic cuts (age, gender, region, income, etc.) are available for a survey.

get_survey_refinement_dataAdvanced

Refine survey results against one or more demographic filters.

get_survey_crosstab_dataAdvanced

Cross-tabulate survey responses across two or more dimensions.

get_survey_all_cutsAdvanced

Return every demographic cut for a survey question in one call.

innovation

list_innovationsconstruction only▼
Available on: construction (site 63) vertical only.
Standard tools
list_innovationsStandard

Search innovation records in the construction and infrastructure sector: new technologies, start-up activity, R&D initiatives, and disruptive products. Filter by innovation type, company, theme, or country.

market_data

get_market_data_analytics▼
Standard tools
get_market_data_analyticsStandard

Retrieve quantitative market data: sector sizing, market share, CAGR, growth forecasts, and production capacity metrics. Calls GlobalData's backend structured data API which performs its own entity matching internally — resolve_entities is not required before calling this tool. Pass the user's natural language question directly as the query parameter. Unlock via discover_capabilities('market_data'). Subscription entitlement required — contact DDStechSupport@globaldata.com if access is denied.

mine_projects

list_mineprojectsmining only▼
Available on: mining (site 58) vertical only.
Standard tools
list_mineprojectsStandard

Search mining projects by commodity type, mine method, development stage, country, or company. Returns mine project records including resource estimates, production status, owner/operator, and geographic location.

get_mine_descriptionsStandard

Full detail record for a single mine project by mineId: description, project value, timeline, equity partners, operators, involved companies, location, and annual production data by commodity/year.

construction_projects (formerly the shared "projects" domain)

list_projectsconstruction only▼
Available on: construction (site 63) only. MEED Projects no longer shares this domain — it has its own meed_projects domain instead (see the MEED Projects block below).
Standard tools
list_projectsStandard

Search infrastructure and capital projects — energy, construction, transportation, utilities — by stage (Announced, Planning, Execution, Completed), sector, value, or geography. Filter by construction start, contract award, tender issue/submission, or project start/end date ranges, company role, development likelihood, or event status.

get_project_descriptionsStandard

Full project detail records: description, value breakdown, timeline, involved companies and their roles, location, and status.

Advanced tools
get_projects_analyticsAdvanced

Aggregate project counts and investment value by status, industry, country, or start date. Requires reveal_advanced('construction_projects').

construction_tenders

list_construction_tendersconstruction only▼
Available on: construction (site 63) vertical only.
Standard tools
list_construction_tendersStandard

Search construction-sector tender notices by category, location, status, or value.

get_construction_tender_detailsStandard

Full detail record for a specific construction tender.

MEED Projects (4 domains)

meed_*meedprojects only▼
Available on: meedprojects (site 71) only — and exclusively these 4 domains plus the common news domain. MEED Projects does not receive the rest of the common content bundle, nor Construction's construction_projects/construction_project_contacts domains.
Standard tools, by domain
meed_projects

Middle East & North Africa infrastructure projects — list_meed_projects / get_meed_project_descriptions + advanced get_meed_projects_analytics.

meed_companies

Companies active in MEED-tracked projects — list_meed_companies / get_meed_company_descriptions / list_meed_company_ranking.

meed_contacts

Decision-maker contacts at MEED-tracked companies — list_meed_contacts / get_meed_contact_descriptions.

meed_project_analysis

Advanced-only — get_meed_project_awards_analysis, get_meed_project_pipeline_analysis, get_meed_cashflow_analysis, get_meed_market_index_analysis.

Strategic Intelligence & Celent Intelligence

reports, theme_scorecardsrestricted verticals▼
strategicintelligence (site 109) is restricted to exactly reports and theme_scorecards. celentintelligence (site 113) is restricted to reports only. Neither receives the common content bundle (companies, deals, news, etc.), themes_map, or any other domain — this is an explicit platform access restriction, not an oversight.
Domains
reports

Same list_reports / get_report_descriptions tools documented in the reports domain above.

theme_scorecards

Same list_theme_scorecards tool documented above — strategicintelligence only, not celentintelligence.

stylus_reports

get_stylus_reportsstylus only▼
Available on: stylus (site 115) only — the only domain this vertical has. No common content bundle.
Standard tools
get_stylus_reportsStandard

Semantic search over Stylus reports — retrieves the most relevant report content for a natural-language question rather than exact keyword matching.

fdi_projects

list_fdiprojects▼
Available on all verticals — not site-restricted, unlike the projects domain above.
Standard tools
list_fdiprojectsStandard

Search and list Foreign Direct Investment (FDI) projects worldwide — cross-border capital investment tracking by investing company, destination country, sector, or theme. Subscription entitlement required.

ict_contracts

list_ict_contractstechnology only▼
Available on: technology (site 55) vertical only. Subscription entitlement required.
Standard tools
list_ict_contractsStandard

List IT software, service, or telecom contract records across the technology market, selected via a category parameter (Software / Service / Telecom). Does not require a company ID — filterable by date and category.

get_ict_contract_descriptionsStandard

Full ICT contract details for a specific company: vendor, client, contract value, duration, and category. Requires a category value.

Advanced tools
get_ict_contract_analyticsAdvanced

Aggregate contract volume and value by vendor, client, industry, contract type, region, or year. Requires reveal_advanced('ict_contracts').

ict_client_prospector

list_planned_technology_prioritiestechnology, disruptor▼
Available on: technology (site 55) and disruptor (site 56) verticals.
Standard tools
list_planned_technology_prioritiesStandard

Search companies' planned/upcoming technology investment priorities and IT initiatives.

Advanced tools
get_ict_client_prospector_analyticsAdvanced

Aggregate planned technology priority data for prospecting analysis.

get_it_events_analyticsAdvanced

Aggregate IT-relevant corporate events (e.g. contract renewals, leadership changes) for prospecting.

get_install_base_analyticsAdvanced

Aggregate technology install-base data by vendor, product, or company.

partner_network_database

tech_partner_network_datatechnology only▼
Available on: technology (site 55) vertical only.
Standard tools
tech_partner_network_dataStandard

Search technology vendor partner-network and alliance relationships.

pldb

list_pldbconsumer only▼
Available on: consumer (site 1) vertical only.
Standard tools
list_pldbStandard

Search Product Lifecycle Database (PLDB) records worldwide: products by industry, location, closure material, closure type, or pack sub-type. Returns product summaries (title, industry, location, published date).

Product & pricing intelligence (4 domains)

pla, ingredients, packtrack, pricingconsumer, packaging, oilgas▼
All 4 domains below are available on consumer (site 1), packaging (site 5), and oilgas (site 61) — the same three-vertical scope across all of them.
Standard tools, by domain
pla

Product Launch Analytics — list_product_launch_analytics / get_product_launch_analytics_descriptions.

ingredients

Ingredient Profiles — list_ingredients / get_ingredients_descriptions.

packtrack

Pack-Track packaging intelligence — list_packtrack_products / get_packtrack_products_descriptions.

pricing

Price Intelligence — list_pricing_companies / get_pricing_details / get_pricing_product_counts.

global_ads

list_globalads▼
Available on all verticals — not site-restricted.
Standard tools
list_globaladsStandard

Search TV, print, and YouTube advertising records for a company — media type, brand/product, country, and YouTube engagement metrics (views, likes).

get_globalads_descriptionsStandard

Full ad record detail by ID.

defence_projects

list_defenceprojectsads only▼
Available on: ads (Aerospace, Defence & Security, site 51) vertical only.
Standard tools
list_defenceprojectsStandard

Search aerospace, defence, and security project records by sector, stage, value, or geography.

get_defenceproject_descriptionsStandard

Full defence project detail: contractor, client, project value, and description.

innovation_explorer

list_innovationexplorerdisruptor, insurance▼
Available on: disruptor (site 56) and insurance (site 64) verticals.
Standard tools
list_innovationexplorerStandard

Search emerging-technology and disruptor innovation profiles by title, location, or industry taxonomy.

get_innovationexplorer_descriptionsStandard

Full innovation profile detail: overview, taxonomy, and related companies.

regulatory_updates

list_regulatoryupdatesinsurance only▼
Available on: insurance (site 64) vertical only.
Standard tools
list_regulatoryupdatesStandard

Search insurance regulatory update records by jurisdiction, topic, or date.

get_regulatoryupdates_descriptionsStandard

Full detail for one or more regulatory update records.

list_regulatorycomplianceStandard

Search insurance regulatory compliance requirement records.

get_regulatorycompliance_descriptionsStandard

Full detail for one or more compliance requirement records.

list_regulatory_compliance_fullStandard

Search the full regulatory compliance dataset across jurisdictions.

get_regulatory_compliance_full_descriptionsStandard

Full detail for records from the full regulatory compliance dataset.

menu_intelligence

list_restaurantsfoodservice only▼
Available on: foodservice (site 67) vertical only.
Standard tools
list_restaurantsStandard

Search restaurant/foodservice outlet records by chain, cuisine, country, or format.

get_restaurant_descriptionsStandard

Full detail record for one or more restaurant outlets.

list_menuitemsStandard

Search individual menu items by restaurant, category, price, or ingredient.

get_menuitem_descriptionsStandard

Full detail record for one or more menu items.

Advanced tools
get_menu_analyticsAdvanced

Aggregate menu item data by category, price band, or restaurant chain. Requires reveal_advanced('menu_intelligence').

power_plants

list_plantspower only▼
Available on: power (site 62) vertical only.
Standard tools
list_plantsStandard

Search power generation plants across every technology type — thermal, nuclear, hydro, wind, solar, geothermal, ocean, biopower — by technology, location, status, capacity, or company role (owner, developer, EPC, manufacturer).

get_plant_descriptionsStandard

Full power plant detail by ID.

power_decommission_analyzerStandard

Identifies ageing plants at decommissioning risk.

power_upcoming_plantsStandard

Announced and under-construction plant pipeline.

mining_cost_curve

list_mining_cost_curvemining only▼
Available on: mining (site 58) vertical only. Sibling to mine_projects, not the same domain.
Standard tools
list_mining_cost_curveStandard

Search mining production cost curve records by commodity, cost curve type, product type, mine, or year.

Advanced tools
get_mining_cost_curve_analyticsAdvanced

Cross-mine/company/country production cost benchmarking, with cumulative production and chart-ready cost bars. Requires reveal_advanced('mining_cost_curve').

sports_athletes

list_athletessport only▼
Available on: sport (site 84) vertical only.
Standard tools
list_athletesStandard

Search athletes/players by sport discipline, country, gender, or active/retired status.

sports_venues

list_venuessport only▼
Available on: sport (site 84) vertical only.
Standard tools
list_venuesStandard

Search venues and stadiums by sport discipline, country, or operational status.

sports_competitions

list_competitionssport only▼
Available on: sport (site 84) vertical only. Three-level hierarchy — walk it as list_properties → list_competitions (by propertyIds) → list_calendarevents (by competitionId or propertyId).
Standard tools
list_propertiesStandard

Search competition-series ("properties", e.g. "FIM Sidecar World Championship") by sport, country, year, competition type, or gender.

list_competitionsStandard

Search competitions/tournaments/leagues by sport, country, active status, or year.

list_calendareventsStandard

List calendar events (fixtures, rounds, matches) for a specific competition or property-series.

sports_conferences

list_conferencessport only▼
Available on: sport (site 84) vertical only.
Standard tools
list_conferencesStandard

Search sport conferences and industry events by country/city, conference type, status, or date range.

sports_deals

list_sponsorship_dealssport only▼
Available on: sport (site 84) vertical only. One tool per deal kind — for financial/M&A deals across all verticals (not just sport), use the general deals domain instead.
Standard tools
list_sponsorship_dealsStandard

Sponsorship agreements between brands and rights-holders, by sport, geography, theme, status, value, or date.

list_media_dealsStandard

Media and broadcast rights deals.

list_bidding_dealsStandard

Host-city / event hosting-rights bidding deals.

list_financial_sport_dealsStandard

Financial/M&A deals involving sport entities.

Advanced tools
get_sponsorship_deals_analyticsAdvanced

Aggregate sponsorship deal volume/value. Requires reveal_advanced('sports_deals').

get_media_deals_analyticsAdvanced

Aggregate media/broadcast rights deal volume/value.

get_bidding_deals_analyticsAdvanced

Aggregate host-city/event bidding deal volume.

get_financial_sport_deals_analyticsAdvanced

Aggregate financial/M&A sport deal volume/value.

sports_brands

list_sponsorshipbrandssport only▼
Available on: sport (site 84) vertical only.
Standard tools
list_sponsorshipbrandsStandard

Search and rank sponsorship brands by industry, HQ, sport sponsored, beneficiary, relationship, status, or total/annual spend.

stadium_projects

list_stadium_projectssport only▼
Available on: sport (site 84) vertical only.
Standard tools
list_stadium_projectsStandard

Stadium Construction Database — search stadium/arena construction and redevelopment projects by geography, stage, value, contractor, or funding.

Advanced tools
get_stadium_projects_analyticsAdvanced

Aggregate stadium project counts/value by country, stage, sector, contractor, or year. Requires reveal_advanced('stadium_projects').

sports_media_revenues

list_media_revenuessport only▼
Available on: sport (site 84) vertical only. Two-step pattern: list_media_revenues discovers which revenue series exist for a property, then compare_media_revenues returns year-by-year figures.
Standard tools
list_media_revenuesStandard

Discover which media-rights revenue series exist for a sport property.

compare_media_revenuesStandard

Year-by-year media-rights revenue figures (US$m) for comparison across properties or years.

Oil & Gas (6 domains)

og_*oil and gas only▼
Available on: oil and gas (site 61) vertical only. Six separate domains sharing an og_* tool-name prefix; all SQL-backed (not Elasticsearch) against the Oil & Gas database — the first production domain to use this pattern.
Standard tools, by domain
upstream

Exploration blocks, fields, wells, bid rounds, permits, and vessels — og_blocks_listing/details, og_fields_listing/details, og_international_wells_listing/details, og_us_wells_list/details, og_bid_rounds_listing/og_bid_round_details, og_us_well_permits_listing/details, og_vessels_listing/details.

midstream

Gas processing, gas & liquid storage, LNG, pipelines — og_gas_processing_listings/details, og_gas_storage_listing/details, og_liquid_storage_listing/details + advanced og_liquid_storage_analytics, og_lng_liquefaction_listing/details, og_lng_regasification_listing/details, og_lng_imports_listing/details, og_lng_exports_listing/details, og_pipelines_listing/pipeline_details.

downstream

Petrochemical plants and refineries — og_petrochemicals_listing/petrochemical_details, og_refinery_listing/details, og_refinery_utilization_listing.

oilgas_energy_transition

Carbon capture (CCUS) and O&G hydrogen production — og_carbon_capture_listing/details, og_hydrogen_plants_listing/details (a separate implementation from Power's own hydrogen-plants tool — each cross-references the other to prevent misrouting).

equipment_and_services

Services/equipment/construction contracts and upstream/midstream project records — og_contracts_listing/contract_details, og_projects_listing/project_details.

operation_metrics

Company production/reserves/lifting-cost KPIs — og_operational_metrics.

Power — tenders, auctions, storage & more (10 more domains)

list_power_*power only▼
Available on: power (site 62) vertical only, alongside the power_plants domain above. All Elasticsearch-backed except equipment_markets (SQL-backed).
Standard tools, by domain
tenders_and_contracts

list_power_tenders / get_power_tenders_descriptions — power-sector tenders and contracts by category, segment, equipment, technology, location, or client/vendor.

auctions

list_power_auctions / get_power_auction_descriptions — renewable-energy auction results, awarded capacity, clearing prices/tariffs.

td_projects

list_power_tnd_projects / get_power_tnd_projects_descriptions / list_td_networks — transmission & distribution line/substation projects and network records by type, location, status, voltage, or system operator.

td_interconnection_projects

list_td_interconnection_projects — cross-border and inter-regional transmission interconnection projects.

td_system_operators

list_td_system_operators — transmission/distribution system operator (TSO/DSO) company records.

td_investment

list_td_investment — transmission & distribution capital investment records.

energy_storage_projects

list_power_storage / get_power_storage_descriptions — battery, pumped hydro, and hydrogen storage projects by technology, location, capacity, or company role.

smart_grid_projects

list_smart_grid_projects — AMI, DSM, EV charging, grid modernization, and microgrid projects.

power_energy_transition

list_hydrogen_plants / get_hydrogen_plant_descriptions — power-sector hydrogen plants by operator, process, technology, or development stage.

equipment_markets

list_equipment_markets — power equipment market value/volume/capacity by technology, region, or year.

Section 08

Working with the gateway

A nine-step lifecycle covers every MCP session from connection through to presenting results.

  1. Connect & authenticate. Open the MCP session over Streamable HTTP. Authenticate via GlobalData SSO — credentials flow for server agents, OAuth 2.1 PKCE for interactive clients.
  2. Orient (optional). Call list_domains to see available domains for your vertical with unlock status. Skip when your agent already knows the tool it needs.
  3. Reveal what you need. discover_capabilities('domain') exposes standard tools; reveal_advanced('domain') adds analytics. Or skip revealing entirely and use the search facade — it dispatches to any tool, revealed or not. Immediately after a reveal call, prefer search(domain, keywords) over calling the new tool by name — your client's local tool list may not have refreshed yet.
  4. Resolve entities. For any taxonomy term — industry, location, theme, deal type, news category, sentiment — call resolve_entities first with a domain hint. Free-text fields (companyName, keyword) pass through unchanged and do not need resolving.
  5. Search. Call the list_* tool with resolved filters, or use search by natural-language intent. At least one selective filter is required — a bare geography with no other filter is rejected pre-flight.
  6. Verify the scope. Read applied_filters (true scope after canonicalisation), resolved (term mapping with confidence scores), dropped_filters and warnings (anything silently lost). Counts are meaningless until scope is confirmed.
  7. Chain or compose. Pass Company IDs forward to the next domain tool to retrieve deals, filings, jobs, or patents for that company. Company ID is the primary join key across all content domains.
  8. Paginate. When pagination.has_more is set, re-call with the next page_number. The envelope provides next_page.example_args ready to use directly.
  9. Present in two parts. Resolution first — terms, canonical values, confidence, anything dropped — then data. A wrong resolution silently rescopes everything downstream.
Skip resolve_entities when you already have an IDIf a prior call already gave you a canonical ID — a company_id from list_companies, a mineId, a bidRoundId, and so on — pass it straight to the next tool. Most tool descriptions now say explicitly when ID-based parameters bypass resolve_entities entirely; re-resolving an ID you already have just adds a redundant round trip.

Entity dimensions you can resolve

Common (all verticals): industry · location · theme · hqCountry
Deals: dealType · dealStatus · dealRationale · acquirerCountry
News: newsCategory · sentiment
Mining: commodity · mineMethod · mineStage
Free-text (no resolve needed): companyName · keyword · job title · text search fields

Entity resolution pipeline

Free-text input
"mining sector"
"Acquisition"
"Asia Pacific"
➞
BM25 + KNN
Hybrid Search
ElasticSearch
taxonomy index
➞
Confidence
score
≥ 0.65 → pass
< 0.65 → drop
➞
Canonical value
industry: "Mining"
dealType: "Acquisition"
location: "Asia-Pacific"
Dropped
returned in
dropped_filters
This diagram shows the open-taxonomy path (industry, location, theme, etc. — BM25+KNN against GlobalData's taxonomy index). Fixed-choice fields like dealType/sentiment/newsCategory take a separate, simpler path: an exact/alias match against a known list first, and — new as of July 2026 — an AI-assisted fuzzy match as a second attempt before a value is dropped (so a near-miss like "Geographical Expansion" now still resolves to "Geographic Expansion" instead of silently failing). Either way, check the resolved/metadata block for how a value was matched before trusting it.

Response envelope

FieldMeaning
resultThe data payload — actual records from the backend tool.
delegated_tool · routeWhich tool the facade ran and why. Confirm intent was interpreted correctly.
applied_filtersTrue scope after canonicalisation. Always verify before reporting counts or quoting results.
resolvedFull resolve_entities payload: each input term, canonical value mapped to, and confidence score.
dropped_filters · warningsAny filter that couldn't be honored or was silently dropped.
scope_warningRaised when a primary filter couldn't apply and the call continued with degraded scope.
paginationpage, page_size, returned, total_records, total_pages, has_more, next_page.example_args
routing_hint · no_results_hintSibling tools to try when routing was ambiguous or results are empty.
unknown_fieldsFields passed to fields= that didn't match — the rest still project correctly.
Pre-flight rejection: A query with no selective filter is rejected before execution with a result_set_too_large error that lists the filters which would make it valid.
Section 09

Worked examples

Typical call sequences per domain. Each example shows the intent and the tool calls in order.

companies

▼
"All technology companies headquartered in the US"
1
resolve_entities — hqCountry="US", industry="Technology" → canonical values
2
list_companies — pass resolved hqCountry, industry
"Full profile for Siemens with financials"
1
list_companies — companyName="Siemens" → extract Company_ID
2
get_company_descriptions — pass Company_ID
"Revenue analytics by sector for mining companies"
1
reveal_advanced('companies')
2
resolve_entities — industry="Mining"
3
get_company_analytics — groupBy="industry", resolved industry

deals

▼
"M&A activity in APAC technology sector this year"
1
resolve_entities — dealType="Acquisition", location="Asia-Pacific", industry="Technology"
2
list_deals — resolved filters + from_date for current year
"All deals involving a specific company"
1
list_deals — companyName="X" → extract Deal_IDs
2
get_deals_descriptions — pass Deal_IDs
"Deal count and value trends by type, last 5 years"
1
reveal_advanced('deals')
2
get_deals_analytics — groupBy="dealType", date range

news

▼
"Negative sentiment news about a company last month"
1
resolve_entities — sentiment="Negative"
2
list_newsarticles — companyName=X, resolved sentiment, date range
"News volume and sentiment trend for an industry over the past year"
1
reveal_advanced('news')
2
resolve_entities — industry="Renewable Energy"
3
get_news_analytics — groupBy="month", resolved industry, date range

filings

▼
"Latest annual reports for a company"
1
list_filing — companyName=X, filingType="Annual Report"
"Extract 'supply chain risk' mentions from a filing"
1
list_filing — find filing, extract Filing_ID
2
get_filingsentences — Filing_ID, keyword="supply chain risk"
"Full text of a specific filing"
1
list_filing → Filing_ID
2
get_filing_document_text — returns time-limited download URL

patents

▼
"Patents filed by a company in a specific IPC class"
1
list_patents — assignee="Company X", ipcCode="H01M"
"All patents for a technology theme"
1
resolve_entities — industry="Battery Technology"
2
list_patents — resolved industry as keyword filter

jobs

▼
"Engineering job postings in Germany for a company"
1
resolve_entities — location="Germany"
2
list_jobs — companyName=X, occupation="Engineering", resolved location
"Hiring trend analytics by role for a sector"
1
reveal_advanced('jobs')
2
resolve_entities — industry="Technology"
3
get_jobs_analytics — groupBy="occupation", resolved industry

construction_project_contacts (construction only)

▼
"C-level decision makers at a major construction company"
1
list_contacts — companyName="X", seniority="C-Level"

reports

▼
"Latest GlobalData reports on electric vehicle batteries"
1
resolve_entities — industry="Automotive", theme="Electric Vehicles"
2
list_reports — resolved filters
"Full abstract for a specific research report"
1
list_reports → extract Report_ID
2
get_report_descriptions — pass Report_ID

social

▼
"Social media sentiment for a company this week"
1
resolve_entities — sentiment="Negative" (if filtering by sentiment)
2
list_socialmediaposts — companyName=X, from_date this week, resolved sentiment

buying_signals

▼
"BD leads in the pharmaceutical sector"
1
resolve_entities — industry="Pharmaceuticals"
2
list_buying_signals — resolved industry
"Buying signal volume by month for the last year"
1
reveal_advanced('buying_signals')
2
get_buying_signals_analytics — groupBy="month", date range

innovation (construction only)

▼
"New construction technology innovations in sustainability"
1
resolve_entities — theme="Sustainability"
2
list_innovations — resolved theme

construction_projects (construction only — see MEED Projects' own domains for that vertical)

▼
"Energy projects announced in Saudi Arabia in 2024"
1
resolve_entities — industry="Energy", location="Saudi Arabia"
2
list_projects — resolved filters, stage="Announced", date range
"How many projects are in execution stage in the Middle East?"
1
reveal_advanced('construction_projects')
2
resolve_entities — location="Middle East"
3
get_projects_analytics — groupBy="status", resolved location

fdi_projects

▼
"FDI projects by Chinese companies in Africa"
1
resolve_entities — location="Africa"
2
list_fdiprojects — companyName="China"-scoped keyword, resolved destination location

ict_contracts (technology only)

▼
"List recent IT service contracts"
1
list_ict_contracts — category="Service"
"Full details for a specific software contract"
1
list_ict_contracts → extract contract ID
2
get_ict_contract_descriptions — contract ID, category="Software"
"Top vendors by contract value this year"
1
reveal_advanced('ict_contracts')
2
get_ict_contract_analytics — groupBy="vendor", date range

pldb (consumer only)

▼
"Products packaged in glass bottles in Germany"
1
resolve_entities — location="Germany", pldb_pack_sub_type="Bottle - Glass"
2
list_pldb — resolved location, pack sub-type
Section 10

Data coverage & methodology

Source types, coverage scope, and important caveats per tool. Coverage summary = directly documented scope. Inherits parent = shares the primary tool's coverage.

DomainToolStatusSourcesCoverageWatch for
companieslist_companiesCoverage summaryCompany registries, financial data providers, GlobalData researchCompany profiles globally across all tracked organisationsCompany ID is the master join key for all domains
companiesget_company_descriptionsInherits parent—Detailed financials, subsidiaries, sector classificationInherits list_companies coverage
companiesget_company_analyticsInherits parent—Aggregated metrics by industry, country, revenue band, yearRequires reveal_advanced; inherits list_companies coverage
dealslist_dealsCoverage summaryCompany announcements, press releases, financial news, transaction databasesM&A, licensing, partnerships, JVs across all tracked companiesDeal value may be undisclosed; some deals announced after close
dealsget_deals_analyticsInherits parent—Aggregated counts and deal valuesInherits list_deals coverage
newslist_newsarticlesCoverage summaryLicensed news feeds, press releases, trade publications, analyst commentaryCurated articles on GlobalData-tracked companies, industries, and themesSentiment score is model-derived — treat as a signal, not a definitive label
filingslist_filingCoverage summaryRegulatory filing portals, stock exchange disclosures, company investor relationsAnnual/quarterly reports, earnings transcripts, investor presentationsFull document text is retrieved via a time-limited access URL
filingsget_filingsentencesInherits parent—Sentence-level extraction with keyword matchingInherits list_filing coverage
patentslist_patentsCoverage summaryInternational and national patent offices and publication databasesPatents across technology, energy, materials, and other sectorsFor drug-level patent expiry data, use the Healthcare Pharma MCP
jobslist_jobsCoverage summaryJob board aggregators and company career pagesPostings from GlobalData-tracked companies; salary normalised to USD where availableHistorical postings may be deduplicated; not all postings include salary data
jobsget_jobs_analyticsInherits parent—Hiring trends by occupation, location, or companySalary analytics require sufficient postings per bucket for reliability
construction_project_contactslist_contactsCoverage summaryCompany websites, professional directories, publicly available business profilesSenior decision-makers and professionals at tracked companiesRequires contacts entitlement; construction only — meedprojects has its own meed_contacts domain
reportslist_reportsCoverage summaryGlobalData analyst research team publicationsMarket sizing, forecasts, sector analyses, and country intelligence reportsReport availability varies by subscription tier
sociallist_socialmediapostsCoverage summarySocial media platforms via licensed data partnershipsPosts mentioning tracked companies and themes, with sentiment scoresPlatform coverage and recency depend on licensing agreements
buying_signalslist_buying_signalsCoverage summaryAggregated from deals, news, hiring, and regulatory event dataBD-relevant events classified by supplier relevanceRenamed from "leads"; classification is rule-based, verify individually before outreach
buying_signalsget_buying_signals_analyticsInherits parent—Aggregated by signal/lead type, company, or monthInherits list_buying_signals coverage
innovationlist_innovationsCoverage summaryConstruction sector R&D databases, start-up intelligence sourcesNew technologies and innovation activity in the construction sectorconstruction vertical only
mine_projectslist_mineprojectsCoverage summaryMining project databases, company announcements, regulatory filingsActive and planned mining projects globally with resource and production datamining vertical only
mine_projectsget_mine_descriptionsInherits parent—Full mine detail: equity partners, operators, involved companies, annual production by commodity/yearTakes a single mineId, not a comma-separated list; inherits list_mineprojects coverage
market_dataget_market_data_analyticsCoverage summaryGlobalData structured data and market intelligence databasesSector-level numeric market data: sizing, share, growth rates, CAGR forecasts — available on all verticalsSubscription entitlement required; resolve_entities not needed — pass natural language query directly
theme_scorecardslist_theme_scorecardsCoverage summaryGlobalData thematic research and scoring methodologyTheme-level scoring and ranking across companies, sectors, countriesCommon bundle on the 20 ordinary verticals; also one of strategicintelligence's two domains
themes_maplist_themesmapCoverage summaryGlobalData thematic research taggingTheme-to-company/sector mappingCommon bundle on the 20 ordinary verticals; not available on strategicintelligence/celentintelligence/stylus/meedprojects
surveyslist_surveys / list_survey_questionsCoverage summaryLicensed consumer/industry survey panelsSurvey and poll records, questions, and demographic cross-tabulationCommon bundle on the 20 ordinary verticals; not available on strategicintelligence/celentintelligence/stylus/meedprojects
surveysget_survey_demographic_filters / get_survey_refinement_data / get_survey_crosstab_data / get_survey_all_cutsInherits parent—Demographic refinement and cross-tabulation of survey responsesInherits list_surveys coverage
construction_projectslist_projectsCoverage summaryProject announcements, tender/contract award notices, company disclosuresInfrastructure and capital projects — energy, construction, transportation, utilitiesconstruction vertical only — meedprojects has its own meed_projects domain
construction_projectsget_project_descriptions / get_projects_analyticsInherits parent—Full detail records and aggregated counts/valuesInherits list_projects coverage
construction_tenderslist_construction_tenders / get_construction_tender_detailsCoverage summaryConstruction tender and procurement noticesConstruction-sector tender notices by category, location, status, valueconstruction vertical only
meed_projectslist_meed_projects / get_meed_project_descriptions / get_meed_projects_analyticsCoverage summaryMEED regional project databases, company disclosuresMiddle East & North Africa infrastructure projectsmeedprojects vertical only
meed_companieslist_meed_companies / get_meed_company_descriptions / list_meed_company_rankingCoverage summaryMEED regional company trackingCompanies active in MEED-tracked projects, with rankingmeedprojects vertical only
meed_contactslist_meed_contacts / get_meed_contact_descriptionsCoverage summaryMEED regional contact directoriesDecision-maker contacts at MEED-tracked companiesmeedprojects vertical only
meed_project_analysisget_meed_project_awards_analysis / get_meed_project_pipeline_analysis / get_meed_cashflow_analysis / get_meed_market_index_analysisCoverage summaryMEED regional project databasesAwards, pipeline, cashflow, and market-index analysis for MEED projectsmeedprojects vertical only; advanced-only domain
stylus_reportsget_stylus_reportsCoverage summaryStylus analyst report corpusSemantic search over Stylus report contentstylus vertical only — the only domain this vertical has
fdi_projectslist_fdiprojectsCoverage summaryCross-border investment announcements, company disclosures, regulatory sourcesForeign Direct Investment projects globally — investing company, destination country/sectorSubscription entitlement required; available on all verticals
ict_contractslist_ict_contracts / get_ict_contract_descriptionsCoverage summaryVendor/client contract disclosures, technology market researchIT software, service, and telecom contracts — vendor, client, contract value, duration, categorytechnology vertical only; subscription entitlement required
ict_contractsget_ict_contract_analyticsInherits parent—Aggregated by vendor, client, industry, contract type, region, or yearInherits list_ict_contracts coverage
ict_client_prospectorlist_planned_technology_prioritiesCoverage summaryTechnology buyer intent and IT investment tracking sourcesCompanies' planned/upcoming technology investment prioritiestechnology, disruptor verticals
ict_client_prospectorget_ict_client_prospector_analytics / get_it_events_analytics / get_install_base_analyticsInherits parent—Aggregated prospecting, IT-event, and install-base analyticsInherits list_planned_technology_priorities coverage
partner_network_databasetech_partner_network_dataCoverage summaryTechnology vendor partnership disclosuresVendor partner-network and alliance relationshipstechnology vertical only
pldblist_pldbCoverage summaryProduct Lifecycle Database — retail and packaging tracking sourcesProducts worldwide by industry, location, closure type/material, pack sub-typeconsumer vertical only
pla / ingredients / packtrack / pricinglist_product_launch_analytics / list_ingredients / list_packtrack_products / list_pricing_companies (see domain explorer above)Coverage summaryProduct launch tracking, ingredient databases, packaging intelligence, and price monitoring sourcesNew product launches, ingredient profiles, packaging formats, and pricing by company/productconsumer, packaging, oilgas verticals only
global_adslist_globalads / get_globalads_descriptionsCoverage summaryTV, print, and YouTube ad monitoring sourcesAdvertising records for a company — media type, brand/product, country, engagement metricsavailable on all verticals
defence_projectslist_defenceprojects / get_defenceproject_descriptionsCoverage summaryDefence procurement announcements, contractor disclosuresAerospace, defence, and security project records — sector, stage, value, geographyads vertical only
innovation_explorerlist_innovationexplorer / get_innovationexplorer_descriptionsCoverage summaryEmerging-technology and start-up intelligence sourcesDisruptor/emerging-tech and Insurance innovation profiles — title, location, taxonomy, related companiesdisruptor, insurance verticals
regulatory_updateslist_regulatoryupdates / list_regulatorycompliance / list_regulatory_compliance_fullCoverage summaryInsurance regulatory and compliance tracking sourcesRegulatory updates and compliance requirements by jurisdiction and topicinsurance vertical only
menu_intelligencelist_restaurants / list_menuitemsCoverage summaryRestaurant menu and foodservice outlet tracking sourcesRestaurant outlets and individual menu items by chain, category, pricefoodservice vertical only
menu_intelligenceget_menu_analyticsInherits parent—Aggregated menu data by category, price band, or chainRequires reveal_advanced; inherits list_restaurants/list_menuitems coverage
power_plantslist_plants / get_plant_descriptionsCoverage summaryPower generation asset databases, company disclosures, regulatory filingsPower plants across every technology type — thermal, nuclear, hydro, wind, solar, geothermal, ocean, biopowerpower vertical only
mining_cost_curvelist_mining_cost_curveCoverage summaryMining production cost databases, company disclosuresProduction cost curve line items by commodity, mine, and year, for cross-industry benchmarkingmining vertical only; sibling to mine_projects, not the same domain
mining_cost_curveget_mining_cost_curve_analyticsInherits parent—Cross-mine/company/country cost benchmarking with cumulative productionInherits list_mining_cost_curve coverage
sports_athleteslist_athletesCoverage summarySport industry databases, federation/league sourcesAthletes/players by sport discipline, country, gender, active statussport vertical only
sports_venueslist_venuesCoverage summarySport industry databases, venue operator sourcesVenues/stadiums by sport discipline, country, operational statussport vertical only
sports_competitionslist_properties / list_competitions / list_calendareventsCoverage summarySport industry databases, federation/league sourcesCompetition-series, competitions/tournaments, and their calendar events (fixtures, rounds)sport vertical only; three-level hierarchy, see domain explorer above
sports_conferenceslist_conferencesCoverage summarySport industry event calendarsSport conferences and industry events by country/city, type, status, datesport vertical only
sports_dealslist_sponsorship_deals / list_media_deals / list_bidding_deals / list_financial_sport_dealsCoverage summarySport industry deal announcements, company disclosuresSponsorship, media-rights, host-city bidding, and financial/M&A deals in sportsport vertical only; one tool per deal kind
sports_brandslist_sponsorshipbrandsCoverage summarySport sponsorship tracking sourcesSponsorship brands ranked by industry, HQ, sport, relationship, spendsport vertical only
stadium_projectslist_stadium_projects / get_stadium_projects_analyticsCoverage summaryStadium Construction Database, contractor disclosuresStadium/arena construction and redevelopment projects; aggregated by country, stage, sector, contractor, yearsport vertical only
sports_media_revenueslist_media_revenues / compare_media_revenuesCoverage summarySport media-rights market data sourcesMedia-rights revenue series per property; year-by-year US$m comparisonsport vertical only
upstream / midstream / downstream / oilgas_energy_transition / equipment_and_services / operation_metricsog_* (~31 tools — see domain explorer above)Coverage summaryOil & Gas project databases, company disclosures, regulatory filingsExploration blocks/fields/wells/bid rounds/permits/vessels, gas & liquid storage, LNG (incl. imports/exports), pipelines, refineries (incl. utilization), petrochemicals, carbon capture, hydrogen, contracts, and operational KPIsoil and gas vertical only; SQL-backed, not Elasticsearch — see developer bible for the pattern
tenders_and_contracts / auctions / td_projects / td_interconnection_projects / td_system_operators / td_investment / energy_storage_projects / smart_grid_projects / power_energy_transition / equipment_marketslist_power_* / list_td_* / list_smart_grid_projects / list_hydrogen_plants / list_equipment_markets (see domain explorer above)Coverage summaryPower-sector tender/auction registries, project databases, system-operator and investment records, company disclosuresPower tenders, renewable auctions, T&D projects/interconnections/system operators/investment, energy storage, smart grid, power-sector hydrogen, equipment marketspower vertical only
Section 11

Tool updates & versioning

How the platform handles tool changes and how your client picks them up.

New connections are always current

Every fresh MCP session receives the latest tool definitions at initialize / tools/list. There is no cross-session caching of tool schemas on the client.

Live sessions are notified

When the tool set changes, the gateway emits notifications/tools/list_changed. Compliant MCP clients re-fetch the tool list automatically without requiring a reconnection.

New capabilities via search immediately

The search facade routes to newly shipped tools on deployment — even before a client has been restarted or revealed the domain.

Compatibility promise: Tool changes are additive and backward-compatible. Breaking changes ship as new tool names; old names are deprecated with advance notice and a migration window before removal.

Per-client refresh behaviour

ClientHow to pick up new tools
Any fresh connectAlways automatic
OpenAI Responses APIAutomatic — tool list fetched per run
claude.ai connectorUsually automatic via notifications/tools/list_changed; toggle the connector off and on if needed
Claude DesktopManual — restart the app to reload tool definitions
Copilot StudioManual — re-sync the MCP tool and republish the agent
Custom MCP clientDepends on whether the client handles notifications/tools/list_changed; otherwise reconnect
Section 12

Frequently asked questions

Which transport does the gateway use?▼
Streamable HTTP MCP. POST JSON-RPC 2.0 payloads to https://mcp.globaldata.com/{site}/mcp. The same endpoint handles both standard request/response and streaming (SSE) responses.
Why don't I see data tools after connecting?▼
Progressive discovery. Only the seven gateway tools are visible at connect time. Call discover_capabilities('companies') (or any domain name) to reveal that domain's standard tools. Call reveal_advanced('companies') to also reveal analytics tools. Which tools you can actually see depends mainly on your subscription's entitlement — a domain your subscription doesn't include won't reveal no matter how many times you call it, and the response will say so directly. For an entitled domain, the reveal happens server-side immediately, but your client may need a moment (or a tools/list re-fetch) to see the new tools — see fq15.
Do I have to reveal a domain to use it?▼
Not through the search facade — it routes to any tool, revealed or not, and doesn't depend on your client's local tool list being current. Calling a specific list_* or get_* tool by name does require the domain to be revealed and your client to have picked up the updated tool list — which is why search is the more reliable choice right after a reveal call.
How do I pick the right vertical/site slug?▼
See the verticals table in Section 07. Full slug list: consumer, retail, packaging, ads, financialservices, technology, disruptor, mining, oilgas, power, construction, insurance, automotive, tourism, foodservice, apparel, meedprojects, sport, explorer, agri, strategicintelligence, celentintelligence, stylus. The last three are restricted verticals — see fq5 and the Intelligence Centers table in Section 07.
Are projects and contacts available on all verticals?▼
No. construction_projects/construction_project_contacts (previously the shared generic projects/contacts domains, same tool names) are now construction (63) only — meedprojects (71) no longer shares them, and instead has its own exclusive domain set: meed_projects, meed_companies, meed_contacts, meed_project_analysis, plus the common news domain, and nothing else (no common bundle). The innovation domain is construction only. The mine_projects domain is mining (58) only. The ict_contracts/ict_client_prospector domains are technology (55) only, except ict_client_prospector which is also on disruptor (56). The pldb domain is consumer (1) only. pla/ingredients/packtrack/pricing are shared by consumer, packaging (5), and oilgas (61). regulatory_updates is insurance (64) only, menu_intelligence is foodservice (67) only, and construction_tenders is construction only. The separate fdi_projects domain (list_fdiprojects) is the exception to all of this — it's available on every ordinary vertical, same as global_ads, theme_scorecards, themes_map, and surveys. strategicintelligence, celentintelligence, and stylus are fully restricted verticals and receive none of the above except the specific domains listed for them in Section 07.
My query came back empty — what happened?▼
Check: (1) the resolved block — low-confidence mapping may have searched the wrong scope; (2) no_results_hint — suggests sibling tools that may have the data; (3) ensure at least one selective filter was passed — bare geography alone is pre-flight rejected.
The counts look wrong — how do I verify the scope?▼
Read applied_filters — this is the true scope after canonicalisation. Also check dropped_filters and warnings for filters that were silently not applied.
What does the confidence score from resolve_entities mean?▼
A 0–1 score reflecting match quality between your input term and the canonical taxonomy value. Scores below 0.65 are rejected by default and the filter is dropped. Fixed-choice fields (like dealType or sentiment) work a little differently: a plain text match is tried first, and an AI-assisted fuzzy match is tried second before giving up — you can tell which happened from the match method in the resolved block. Always inspect that block before trusting results.
How do I chain multiple domains?▼
Pass Company IDs (from list_companies) as arrays to the next domain tool. Company ID is the primary join key across all content domains. For example, pass company_ids=[12345] to list_deals or list_filing.
How do I paginate large results?▼
Check pagination.has_more. If true, use pagination.next_page.example_args from the response for the exact arguments to pass in your next call — simply increment page_number by 1.
What entity dimensions can I resolve?▼
Common: industry, location, theme, hqCountry. Deal-specific: dealType, dealStatus, dealRationale. News: newsCategory, sentiment. Mining: commodity, mineMethod, mineStage. Free-text fields (companyName, keyword) pass through unchanged.
Do I need a special entitlement for contacts?▼
Yes — list_contacts requires a contacts entitlement. Contact the DDS team at Contact us if you receive an entitlement error.
How current is the data?▼
Varies by domain. Company financials and news are typically updated within ~2 business days of a release. Job postings are near real-time. Research report updates depend on analyst publication schedules. Check the publication date in the result record for the authoritative timestamp.
Are my queries logged?▼
Yes — each MCP call is recorded against your credential for usage analytics and rate limiting. Do not pass personally identifiable information in query strings.
A new tool was added — why don't I see it? / I revealed a domain and got "tool not found"▼
Check for a not_entitled response first — if your subscription doesn't include the domain, no amount of re-revealing or reconnecting will make the tool appear. Beyond that, it's a client tool-list refresh issue: the tool is enabled server-side, but your client's local list hasn't caught up yet. For a domain you just revealed with discover_capabilities/reveal_advanced, call search(domain, keywords) instead of the tool by name — it doesn't depend on your local list at all. If you need the tool callable by name, re-fetch tools/list and confirm it appears before calling it. Note that if your client doesn't maintain a persistent connection to the gateway, it may need to re-discover from scratch on every call rather than the reveal "sticking" — this is expected, not a bug. For persistently missing tools after a platform update: reconnect or restart your client — Claude Desktop requires a full app restart, claude.ai needs the connector toggled off then on, and Copilot Studio needs the MCP tool re-synced and republished.
Something looks wrong in the data — how do I report it?▼
Send the query parameters, the full resolved block, and the applied_filters from the response to Contact us.
Section 13

Access & support

Getting connected and resolving issues.

Get credentials or OAuth registration

Request GlobalData MCP credentials or register an OAuth redirect URI by contacting us. Include your client type (Claude Desktop, claude.ai, OpenAI, Copilot Studio, or custom), the vertical(s) you need, and your preferred authentication flow.

Verify your connection

After connecting, call list_domains. A clean domain list with unlock status for each domain confirms that authentication, transport, and progressive discovery are all working end to end. If the call fails, check your bearer token and ensure your subscription covers the vertical slug you connected to.

EndpointDescriptionAuth
/{site}/mcpMCP protocol endpoint (one per vertical)SSO required
/.well-known/oauth-authorization-serverOAuth 2.1 server metadataPublic
/authorizeOAuth authorization endpointPublic
/tokenToken exchange endpointPublic
/healthService health checkPublic
/.well-known/ai-catalog.jsonAgentic Resource Discovery manifest — machine-readable list of every vertical's MCP server, for AI crawlers that don't already know the site slugsPublic