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 and procurement“Find engineering SMEs in the West Midlands that are growing, have won public-sector work and may need additional working capital.”

Tools called

  • search_companies
  • execute_ukgaap_query
  • search_contracts
  • execute_query

Modules and narrowing

  1. Company index: Engineering SIC codes, West Midlands, live, SME size bands → 1,284 candidates
  2. UK GAAP financials: Turnover up over two periods, cash down or trade debtors rising → 216 match
  3. Contract Finder index: Awarded supplier in last 24 months, any buyer → 41 match
  4. Company index: No new charge in 36 months, no insolvency event → 27 shortlisted

Structured result (illustrative shape)

{
  "answer": "27 engineering SMEs in the West Midlands match all four conditions. The stronges…",
  "columns": [
    "Company",
    "CRN",
    "Turnover trend",
    "Public award",
    "Last charge",
    "Signal"
  ],
  "rows": [
    [
      "Illustrative Engineering Ltd",
      "0XXXXXX1",
      "+18% over 2 periods",
      "NHS trust, £410k, 2025",
      "2021",
      "Working capital"
    ]
  ],
  "provenance": {
    "source": "Companies House filings; Contracts Finder",
    "date": "Filed accounts to 2025; awards to 2026",
    "module": "Company, Financial, Procurement, Lending",
    "usage": "27 company records"
  },
  "next_questions": [
    "Which of these have a director or PSC change in the last 12 months?",
    "Which lenders hold the existing charges?"
  ]
}
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

Find engineering SMEs in the West Midlands that are growing, have won public-sector work and may need additional working capital.

Stage 1 of 5

Understanding the request

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

  • Geography: West Midlands
  • Sector: engineering
  • Size: SME
  • Growth signal
  • Public contracts
  • Working-capital signal

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
  • Financial Intelligence
  • Procurement
  • Lending
  • Risk
Read this investigation as text

Question: Find engineering SMEs in the West Midlands that are growing, have won public-sector work and may need additional working capital.

Intent: Geography: West Midlands; Sector: engineering; Size: SME; Growth signal; Public contracts; Working-capital signal.

Tools selected: search_companies, execute_ukgaap_query, search_contracts, execute_query.

Modules queried: Company index (Engineering SIC codes, West Midlands, live, SME size bands: 1,284 candidates); UK GAAP financials (Turnover up over two periods, cash down or trade debtors rising: 216 match); Contract Finder index (Awarded supplier in last 24 months, any buyer: 41 match); Company index (No new charge in 36 months, no insolvency event: 27 shortlisted).

Evidence connected: Turnover growth and debtor build-up from two consecutive filings; Contract award notice with buyer and value; Charge history showing age of last secured facility; Company status, incorporation date and SIC description.

Answer: 27 engineering SMEs in the West Midlands match all four conditions. The strongest signal set combines two years of turnover growth with rising trade debtors, a public-sector award in the last 24 months, and a last registered charge older than three years.

Provenance: Source Companies House filings; Contracts Finder; date Filed accounts to 2025; awards to 2026; module Company, Financial, Procurement, Lending; usage 27 company records.

Suggested next questions: Which of these have a director or PSC change in the last 12 months? / Which lenders hold the existing charges? / Who is the finance contact at the top ten?

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

Built on DataGardener intelligence already used by leading UK organisations.