Skip to content
Eden Engine

GOV.UK Organisation Details (UK Government Departments, Agencies and Public Bodies)

govuk/get-organisation

Looks up one UK government organisation (a department, agency or other public body) by its GOV.UK slug, such as hm-revenue-customs. Returns its title, organisation type, GOV.UK status (live, closed or exempt), abbreviation, public page address, and the organisations linked to it: parents, children, those it replaced and those that replaced it. An unknown slug returns a clear error. Data as published by GOV.UK under the Open Government Licence v3.0, served by Omnial; not an official GOV.UK product.

activeper callv1

Price

$0.0026 per call

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.

Data source

GOV.UK

Contains public sector information licensed under the Open Government Licence v3.0. Served by Eden Engine; not an official GOV.UK product.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

Connect once and your AI can find and run this tool, and any other it needs.

agent
// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "govuk/get-organisation" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "govuk/get-organisation" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "govuk/get-organisation", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "govuk/get-organisation", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

ChargePrice
Per call
$0.0026
Updated
Oct 20, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "pattern": "^[a-z0-9][a-z0-9-]{0,127}$",
      "description": "The organisation's GOV.UK slug: lowercase letters, digits and hyphens, the last part of its page address (https://www.gov.uk/government/organisations/hm-revenue-customs is hm-revenue-customs). The slugs in the parent, child and replaced-by lists of a result can be passed straight back in."
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "required": [
    "id",
    "title",
    "web_url",
    "details"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "GOV.UK API address of this organisation."
    },
    "title": {
      "type": "string",
      "description": "Official title of the organisation."
    },
    "format": {
      "type": "string",
      "description": "Organisation type, for example Non-ministerial department or Executive agency."
    },
    "details": {
      "type": "object",
      "properties": {
        "slug": {
          "type": "string"
        },
        "closed_at": {
          "type": [
            "string",
            "null"
          ],
          "description": "When the organisation closed; null while it is open."
        },
        "content_id": {
          "type": "string"
        },
        "abbreviation": {
          "type": [
            "string",
            "null"
          ],
          "description": "Short name such as HMRC; may be empty or null."
        },
        "govuk_status": {
          "type": "string",
          "description": "GOV.UK status: live, closed or exempt."
        },
        "govuk_closed_status": {
          "type": [
            "string",
            "null"
          ],
          "description": "Why it closed, for example no_longer_exists; null while it is open."
        },
        "logo_formatted_name": {
          "type": "string",
          "description": "The name as laid out beside the logo. Contains HTML such as <br/> and &amp;."
        },
        "organisation_logo_type_class_name": {
          "type": [
            "string",
            "null"
          ]
        },
        "organisation_brand_colour_class_name": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "description": "Core attributes of the organisation.",
      "additionalProperties": true
    },
    "web_url": {
      "type": "string",
      "description": "Public GOV.UK page of the organisation."
    },
    "updated_at": {
      "type": "string",
      "description": "When GOV.UK last updated the record (UTC)."
    },
    "_response_info": {
      "type": "object",
      "description": "The endpoint's own status block, with a link back to this record.",
      "additionalProperties": true
    },
    "child_organisations": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "GOV.UK API address of the organisation."
          },
          "web_url": {
            "type": "string",
            "description": "Public GOV.UK page of the organisation."
          }
        },
        "additionalProperties": true
      }
    },
    "analytics_identifier": {
      "type": [
        "string",
        "null"
      ]
    },
    "parent_organisations": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "GOV.UK API address of the organisation."
          },
          "web_url": {
            "type": "string",
            "description": "Public GOV.UK page of the organisation."
          }
        },
        "additionalProperties": true
      }
    },
    "superseded_organisations": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "GOV.UK API address of the organisation."
          },
          "web_url": {
            "type": "string",
            "description": "Public GOV.UK page of the organisation."
          }
        },
        "additionalProperties": true
      },
      "description": "Organisations this one replaced."
    },
    "superseding_organisations": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "GOV.UK API address of the organisation."
          },
          "web_url": {
            "type": "string",
            "description": "Public GOV.UK page of the organisation."
          }
        },
        "additionalProperties": true
      },
      "description": "Organisations that replaced this one."
    }
  },
  "description": "The GOV.UK record of the organisation.",
  "additionalProperties": true
}