Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
GB_ELI_BASE_URLNoBase URL of the legislation.gov.uk APIhttps://www.legislation.gov.uk
GB_ELI_AUDIT_DIRNoDirectory for audit logs~/.matematic/audit
GB_ELI_CACHE_DIRNoDirectory for caching responses~/.matematic/cache/gb-eli

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
extensions
{
  "io.modelcontextprotocol/ui": {}
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
gb_searchA

Search UK legislation on legislation.gov.uk.

Maps to the official Atom search feed (/all/data.feed or /{doc_type}/data.feed, optionally with ?text=...&year=...&page=...). Each item gets eli_uri, human_readable_citation, source_url (per Art. 4 CONSTITUTION).

gb_get_actB

Fetch UK legislation metadata from legislation.gov.uk by reference.

gb_get_textA

Fetch the full text of UK legislation.

Uses legislation.gov.uk's content-negotiation path suffix (/data.{format}) - xml (the site's own legislation.xsd schema), html, akn (Akoma Ntoso), rdf, pdf, or csv.

gb_recent_legislationA

UK legislation published since since_iso (ISO 8601 date), newest-first.

Maps to the Atom search feed sorted/filtered by publication year, optionally scoped to one doc_type. legislation.gov.uk's public search feed does not support a generic dateFrom filter across all types, so this tool filters the requested year's feed by the published date client-side.

gb_search_case_lawA

Search UK case law on The National Archives' Find Case Law service.

Maps to the public Atom feed at caselaw.nationalarchives.gov.uk/atom.xml (confirmed live 2026-07-06 - keyless, Open Justice Licence). A separate service from legislation.gov.uk: different host, different Atom dialect (tna: namespace).

gb_get_caseA

Fetch a UK judgment from The National Archives' Find Case Law service.

gb_search_govukA

Search GOV.UK documents - tribunal decisions, HMRC manuals, CMA cases and more.

Maps to the GOV.UK Search API (www.gov.uk/api/search.json - confirmed live 2026-07-07: keyless, Open Government Licence v3.0). One upstream aggregating many institutions; filter with document_type. Legally weighty types with live-verified totals (2026-07-07): employment_tribunal_decision (132,162), hmrc_manual_section (85,315), residential_property_tribunal_decision (17,088), employment_appeal_tribunal_decision (2,571), cma_case (2,565), utaac_decision (2,031), tax_tribunal_decision (1,414), asylum_support_decision (101).

gb_get_govuk_contentA

Fetch one GOV.UK document (tribunal decision, HMRC manual section, CMA case).

Maps to the GOV.UK Content API (www.gov.uk/api/content/{path} - confirmed live 2026-07-07). Tribunal decisions carry the judgment as a PDF in attachments with only a short HTML body; HMRC manual sections carry the full text in body_html.

gb_coverageA

Declare what this connector covers, how it is sourced, and what it does NOT cover.

Call this before telling a user that the law "does not contain" something, and whenever a search comes back empty: the absence may be a gap in this connector rather than in the law. Every gap carries a fallback saying where to look instead.

Returns: Coverage with families, an as-of note, and a non-empty list of known gaps.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4/5.0

Scored across 9 tools

Disambiguation4/5

Tools are mostly separated by source and action: legislation search/retrieval vs case law search/retrieval vs GOV.UK content search/retrieval. Minor ambiguity exists between gb_search and the domain-qualified search tools, and between gb_get_act vs gb_get_text for obtaining full legislation text.

Naming Consistency4/5

Names use lowercase snake_case with an gb_ prefix and mostly follow get_/object or search_domain. Deviations are minor: gb_search lacks a resource qualifier, and gb_recent_legislation/gb_coverage are noun-only rather than verb-first.

Tool Count5/5

Nine tools is well-scoped for a read-only legal research connector spanning legislation, case law, GOV.UK documents, and coverage. Each tool has a clear role and none feel redundant.

Completeness4/5

Core workflows are covered: search and retrieve for each major source, plus recent legislation and a coverage mechanism. Minor gaps exist, such as no direct PDF attachment extraction for some GOV.UK tribunal decisions, but gb_coverage explicitly notes known gaps and fallbacks.

Maintenance

ActivityMaintained
ResponsivenessNo issues