Open Data

NHS ODS MCP Server

Chat with AI and run tools instantly — no account needed.

NHS Organisation Data Service API. Search for NHS organisations by name, postcode, role, or status, and retrieve detailed information about specific organisations by ODS code.

2 tools
Agent guide included
Try it Free

No account needed. Chat with AI and run tools instantly.

Browse all tools

AI Skill
SKILL.md

Domain knowledge for NHS ODS — workflow patterns, data models, and gotchas for your AI agent.

NHS Organisation Data Service (ODS)

Official NHS directory of organisations. No authentication required. Provided by NHS Digital (now NHS England).

Data Model

  • Organisation — Any NHS entity: GP practices, hospitals, trusts, CCGs, pharmacies, dental practices, opticians, etc.
  • OrgId — Unique ODS code (e.g. "X26" for NHS England, "RJ1" for Guy's and St Thomas' NHS Foundation Trust).
  • Role — Organisations have one primary role and may have additional roles. Role codes like "RO72" (GP Practice), "RO197" (NHS Trust).
  • Status — Active or Inactive.
  • OrgRecordClass — RC1 (HSCOrg) for health/social care organisations, RC2 (HSCSite) for sites/locations.

Search Parameters

  • Name — Partial name match (case-insensitive)
  • PostCode — Full or partial UK postcode
  • Status — "Active" or "Inactive"
  • PrimaryRoleId — Filter by role code (e.g. "RO72" for GP practices)
  • Limit — Results per page (default 20, max 1000)
  • Offset — Pagination offset

Common Role Codes

  • RO72 — GP Practice
  • RO197 — NHS Trust
  • RO198 — NHS Trust Site
  • RO116 — Executive Agency Programme
  • RO157 — Independent Sector Healthcare Provider
  • RO76 — GP Practice (single-handed)

Gotchas

  • Name search is partial match — "London" returns any org containing "London" in the name.
  • The API returns a maximum of 1000 results per request.
  • Organisation detail includes full address, roles, relationships, and succession history.

Tools in this Server (2)

Nhs Get Organisation

Get detailed information about a specific NHS organisation by its ODS code. Returns full name, address, status, operational/legal dates, roles, relati...

Nhs Search Organisations

Search NHS organisations (GP practices, hospitals, trusts, pharmacies, etc.) by name, postcode, role code, or status. Returns ODS code, name, status, ...

Frequently Asked Questions

What is the NHS ODS MCP server?

NHS Organisation Data Service API. Search for NHS organisations by name, postcode, role, or status, and retrieve detailed information about specific organisations by ODS code. It provides 2 tools that AI agents can use through the Model Context Protocol (MCP).

How do I connect NHS ODS to my AI agent?

Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/nhs-ods. Authentication is handled automatically.

How many tools does NHS ODS provide?

NHS ODS provides 2 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.

What authentication does NHS ODS require?

NHS ODS uses open data APIs — no authentication required.

Setup Instructions

Connect NHS ODS to any MCP client in minutes

https://mcp.mcpbundles.com/bundle/nhs-ods

What is MCP?

Model Context Protocol lets AI tools call external capabilities securely through a single URL. This bundle groups tools behind an MCP endpoint that many clients can use.

Use this bundle in 3 steps

  1. Copy the MCP URL above
  2. Open your AI tool and add a new MCP/connector
  3. Paste the URL and follow any auth prompts

Claude Desktop Users

Skip the manual setup! Use the .mcpb file format for one-click installation. Check the Claude Desktop tab for setup instructions.

Pick your tool tab for exact steps

Select ChatGPT, Cursor, Claude Code, or another tab for copy-paste config.

Try NHS ODS now

No sign-up required. Chat with AI and run tools instantly.

NHS ODS MCP Server & Skill — 2 Tools