Developers
UK company intelligence your agent can call.
Developer overview for DataGardener MCP: a remote Model Context Protocol server with OAuth authorisation, read-only task-level tools across twelve UK intelligence layers, a built-in query knowledge base, and usage reported with results.
How MCP fits
A remote server your MCP host already knows how to talk to.
Your host (Claude, or any MCP client that supports remote servers) connects to DataGardener MCP over HTTPS, discovers its tools, and lets the model call them. You do not write integration code for each dataset; you add one server and the model learns the tools from their definitions.
# Conceptual flow
host ──(MCP over HTTPS, OAuth)──▶ DataGardener MCP
◀── tools/list: 34 tools across 12 layers
model ──▶ tools/call search_companies {...}
◀── structured result + usage
model ──▶ tools/call search_ukgaap {company_registration_number}
◀── filed financials + source + periodTested today with Claude (web, desktop and mobile, via Connectors). Any MCP client that supports remote servers with OAuth authorisation can connect. Clients beyond those listed are not yet tested by DataGardener.
Design principles
Task-level tools
Search tools accept plain parameters such as region, county, industry or value band. Query tools accept full DSL for anything a search cannot express. The agent picks the lightest tool that answers the question.
Server-side defaults
Dissolved and dormant companies are excluded by default from company queries unless the user asks for them, so results reflect the live business population.
Read only
Every tool reads. The server rejects write operations, so an agent can investigate freely without being able to change anything.
Entitled access
Identity travels with the OAuth connection. An agent sees the modules its DataGardener entitlement allows and nothing else.
Metered by record
Record-returning tools are metered per company record returned. Describe and count tools are designed to be used freely before an agent commits to a larger pull.
Knowledge base first
A built-in knowledge base returns the correct field names, nesting rules and KPI templates, so an agent writes correct queries rather than guessing at a schema.
Tool families
12 families, 34 tools, one entitlement.
- Company index3 toolsIdentity, status, SIC, address, directors, growth and risk indicators for UK registered companies, with full Elasticsearch DSL for aggregations.Tools
- Procurement index2 toolsUK public-sector contract notices and awards, including notices published under the Procurement Act 2023 regime (OCDS identifiers, notices dated 2026 present in the index on 3 October 2026).Tools
- Accounts data index2 toolsFiled accounts with industry tags and modified registered addresses for regional analysis.Tools
- Statutory accounts2 toolsFull annual filings: profit and loss, balance sheet, cash flow and employees, linked by registration number.Tools
- UK GAAP financials2 toolsOne record per company per accounting period: P&L, balance sheet, cash flow, headcount, director remuneration and audit cost. All fields top level.Tools
- Persons with significant control2 toolsWho controls each company, nature of control, nationality, residence, and whether control is current.Tools
- Shareholdings2 toolsOne record per shareholding linking an issuing company to an individual or corporate shareholder.Tools
- Group structure4 toolsEach company's immediate parent and ultimate parent, with a second snapshot carrying source-provenance dates so changes can be detected.Tools
- Investor data2 toolsOne document per VC or investor firm with its UK portfolio shareholdings and people.Tools
- Property and land4 toolsEvery residential and commercial price-paid transaction for market context, plus Land Registry titles owned by companies with proprietor registration numbers.Tools
- Global revenue dataset5 toolsGlobal firmographics: industry, size bands, revenue, funding, technology use and open roles, for international context.Tools
- dgsafe dataset4 toolsRead-only access to curated DataGardener collections through filters or aggregation pipelines; writes are rejected by the server.Tools
Developer questions
What transport does DataGardener MCP use?
DataGardener MCP is a remote MCP server. Clients connect over HTTPS using the Model Context Protocol with OAuth authorisation. A legacy login-link flow exists for older SSE connections.
Do I pass a session token?
On OAuth connections, no. The server reads identity from the connection's bearer token. Tools still accept a legacy session_token argument for older connections; pass an empty string on OAuth connections.
How do I write a correct query?
Call query_knowledge_base with a plain description of what you want. It returns the field names, nesting rules and query pattern to use with the execute_* tools.
What happens on an error?
Tool errors are returned as MCP tool results with a message. Typical causes are a malformed DSL body, an unknown field, or a module the connection is not entitled to. The agent can read the message and retry.
Are dissolved companies included?
Not by default. Company queries exclude dissolved and dormant companies unless the user explicitly asks for them.
Build on an operated intelligence layer.
Talk to DataGardener about agent access, design partnerships or OEM terms.