Skip to content

Examples

Prompts in. Evidence out.

Worked examples for DataGardener MCP: natural-language prompts by sector, the tool calls an agent makes, a real sample record with provenance, and the shape of structured results an application receives.

A real call and its result

Sample record, retrieved 3 October 2026

tools/call search_ukgaap
{
  "company_registration_number": "12143071",
  "size": 1
}

The server returned the latest UK GAAP record for this company: period, consolidation flag, balance sheet lines, headcount, and the usage consumed. This is a public Companies House filing.

AUTOMOTIVE PRECISION ENGINEERING LIMITED

CRN
12143071
Period
01/09/2024 to 31/08/2025
Turnover
Not disclosed (small company filing)
Cash at bank
£6,662
Trade debtors
£284,748
Shareholders' funds
£59,199
Employees
11
SourceCompanies House filed accounts (iXBRL)Date3 October 2026ModuleUK GAAP financials indexCRN12143071Usage1 company record

Prompts by sector

What an agent does with each question.

Lending“Which manufacturing businesses around Birmingham may be approaching a refinancing opportunity?”

Tools called

  • execute_query
  • search_ukgaap
  • search_psc

Modules and narrowing

  1. Company index: Manufacturing SIC codes within Birmingham postcode districts, live → 3,912 candidates
  2. Company index (charges): Charge created 36 to 60 months ago, not satisfied, no newer charge → 318 match
  3. UK GAAP financials: Turnover stable or growing, fixed assets rising → 142 match
  4. PSC index: No change of control in last 24 months → 131 shortlisted

Structured result (illustrative shape)

{
  "answer": "131 Birmingham-area manufacturers hold a secured facility between three and five…",
  "columns": [
    "Company",
    "CRN",
    "Charge holder",
    "Charge created",
    "Fixed assets trend",
    "Window"
  ],
  "rows": [
    [
      "Illustrative Metals Ltd",
      "0XXXXXX4",
      "High-street bank",
      "Mar 2022",
      "+31%",
      "Open"
    ]
  ],
  "provenance": {
    "source": "Companies House charges and accounts; PSC register",
    "date": "Charges to Oct 2026; accounts to 2025",
    "module": "Lending, Financial, Ownership",
    "usage": "131 company records"
  },
  "next_questions": [
    "Rank by total secured debt",
    "Which have asset-finance charges specifically?"
  ]
}
Procurement“Which construction SMEs have won public-sector contracts in the North West and show strong financial resilience?”

Tools called

  • search_contracts
  • execute_procurement_query
  • search_statutory_accounts
  • execute_query

Modules and narrowing

  1. Contract Finder index: Awarded construction CPV codes, North West buyers, SME suitable → 2,207 awards
  2. Company index: Resolve awarded suppliers to registration numbers, SME bands → 684 suppliers
  3. Statutory accounts: Positive net assets, positive profit after tax, two consecutive years → 233 match
  4. Company index (risk): No late filings, no outstanding CCJ flags → 198 shortlisted

Structured result (illustrative shape)

{
  "answer": "198 construction SMEs in the North West have won public-sector work and show two…",
  "columns": [
    "Supplier",
    "CRN",
    "Awards (24m)",
    "Largest buyer",
    "Net assets",
    "Resilience"
  ],
  "rows": [
    [
      "Illustrative Build Ltd",
      "0XXXXXX7",
      "4",
      "Metropolitan borough",
      "£2.1m",
      "Strong"
    ]
  ],
  "provenance": {
    "source": "Contracts Finder; Companies House accounts",
    "date": "Awards to Oct 2026; accounts to 2025",
    "module": "Procurement, Company, Financial, Risk",
    "usage": "198 company records"
  },
  "next_questions": [
    "Which of these are also in our supplier list?",
    "Who are the directors in common?"
  ]
}
Economic development“Show me high-growth digital businesses in Croydon founded during the last five years.”

Tools called

  • execute_query
  • execute_accountsdata_query

Modules and narrowing

  1. Company index: Digital and software SIC codes, Croydon postcodes, incorporated since 2021 → 1,058 companies
  2. Accounts data index: Employee growth or turnover growth above threshold between filings → 97 match
  3. Company index: Aggregate by ward and SIC group → Sector map

Structured result (illustrative shape)

{
  "answer": "97 digital businesses founded in Croydon since 2021 show measurable growth in em…",
  "columns": [
    "Company",
    "CRN",
    "Founded",
    "Employees",
    "Growth",
    "Ward"
  ],
  "rows": [
    [
      "Illustrative Software Ltd",
      "1XXXXXX0",
      "2022",
      "4 to 14",
      "+250%",
      "Fairfield"
    ]
  ],
  "provenance": {
    "source": "Companies House; filed accounts",
    "date": "Filings to 2025",
    "module": "Company, Financial, Economy",
    "usage": "97 company records"
  },
  "next_questions": [
    "Which have raised investment?",
    "Which are exporting?"
  ]
}
Supplier intelligence“Which suppliers in this category have experienced important ownership, financial or director changes?”

Tools called

  • search_psc
  • search_group_structure
  • search_gs02
  • execute_query
  • search_ukgaap

Modules and narrowing

  1. PSC index: PSC ceased or added in last 12 months for 88 suppliers → 9 changes
  2. GS02 hierarchy: Ultimate parent differs from previous snapshot → 3 acquisitions
  3. Company index (officers): Director resignations in last 90 days → 12 changes
  4. UK GAAP financials: Net assets fell more than 25% in latest filing → 6 flags

Structured result (illustrative shape)

{
  "answer": "Of 88 suppliers in the category, 22 have a change worth reviewing: three have ch…",
  "columns": [
    "Supplier",
    "CRN",
    "Change type",
    "Detail",
    "Date",
    "Priority"
  ],
  "rows": [
    [
      "Illustrative Services Ltd",
      "0XXXXX10",
      "Ownership",
      "New ultimate parent (overseas)",
      "Aug 2026",
      "High"
    ]
  ],
  "provenance": {
    "source": "PSC register; group structure snapshots; officers; accounts",
    "date": "To Oct 2026",
    "module": "Ownership, People, Financial, Risk",
    "usage": "88 company records"
  },
  "next_questions": [
    "Who is the new parent of the three acquired suppliers?",
    "Which of the 22 hold live contracts with us?"
  ]
}
Market research“Size the UK care-home market and break companies down by region and turnover.”

Tools called

  • execute_query
  • execute_ukgaap_query
  • search_group_structure

Modules and narrowing

  1. Company index: Residential care SIC codes, live, aggregate by region → 15,000+ companies
  2. UK GAAP financials: Latest turnover by band, by region → Turnover matrix
  3. Group structure: Collapse subsidiaries to ultimate parents → Operator view

Structured result (illustrative shape)

{
  "answer": "The agent returns a region-by-turnover matrix for UK residential care operators,…",
  "columns": [
    "Region",
    "Companies",
    "Under £1m",
    "£1m to £10m",
    "Over £10m",
    "Top parent share"
  ],
  "rows": [
    [
      "North West",
      "n",
      "n",
      "n",
      "n",
      "x%"
    ]
  ],
  "provenance": {
    "source": "Companies House; filed accounts; DataGardener group structure",
    "date": "Latest filings",
    "module": "Company, Financial, Economy, Ownership",
    "usage": "Aggregation; records only when drilled into"
  },
  "next_questions": [
    "Which operators grew fastest?",
    "Which have charges with specialist lenders?"
  ]
}
OEM and agent builders“Find companies matching this profile and return structured intelligence for my application.”

Tools called

  • query_knowledge_base
  • execute_query
  • search_ukgaap

Modules and narrowing

  1. Knowledge base: Fetch field names and query pattern for the profile → Pattern
  2. Company index: Match profile filters, return identifiers and status → Matches
  3. UK GAAP financials: Attach latest financials per match → Enriched

Structured result (illustrative shape)

{
  "answer": "Your application receives structured records with registration numbers, status, …",
  "columns": [
    "Field",
    "Example",
    "Source",
    "Date"
  ],
  "rows": [
    [
      "companyRegistrationNumber",
      "0XXXXX13",
      "Companies House",
      "Current"
    ]
  ],
  "provenance": {
    "source": "Companies House; filed accounts; DataGardener indicators",
    "date": "Current",
    "module": "Company, Financial, Risk",
    "usage": "Reported per call"
  },
  "next_questions": [
    "Add contacts for the matches",
    "Watch these for changes"
  ]
}

Result rows are illustrative placeholders showing structure, not live records.

Interactive

Step through an investigation.

Choose a question

Question

Which manufacturing businesses around Birmingham may be approaching a refinancing opportunity?

Stage 1 of 5

Understanding the request

The agent breaks the question into the conditions it must satisfy.

  • Geography: Birmingham and surrounds
  • Sector: manufacturing
  • Charge age
  • Lender relationship
  • Financial trend

Each condition maps to one or more DataGardener intelligence layers. Nothing is guessed: if a condition cannot be evidenced, the agent says so.

  • Company Intelligence
  • Lending
  • Financial Intelligence
  • Risk
  • Ownership
Read this investigation as text

Question: Which manufacturing businesses around Birmingham may be approaching a refinancing opportunity?

Intent: Geography: Birmingham and surrounds; Sector: manufacturing; Charge age; Lender relationship; Financial trend.

Tools selected: execute_query, search_ukgaap, search_psc.

Modules queried: Company index (Manufacturing SIC codes within Birmingham postcode districts, live: 3,912 candidates); Company index (charges) (Charge created 36 to 60 months ago, not satisfied, no newer charge: 318 match); UK GAAP financials (Turnover stable or growing, fixed assets rising: 142 match); PSC index (No change of control in last 24 months: 131 shortlisted).

Evidence connected: Charge date and charge holder from the charges register; Fixed-asset growth from the balance sheet; Ownership stability from the PSC register.

Answer: 131 Birmingham-area manufacturers hold a secured facility between three and five years old with no newer charge, stable ownership and rising fixed assets. These are the conditions under which a refinancing conversation is most often welcome.

Provenance: Source Companies House charges and accounts; PSC register; date Charges to Oct 2026; accounts to 2025; module Lending, Financial, Ownership; usage 131 company records.

Suggested next questions: Rank by total secured debt / Which have asset-finance charges specifically? / Build a borrower brief for the top five

Your agents already know how to think.Give them something worth knowing.

Built on DataGardener intelligence already used by leading UK organisations.