Skip to main content

MCP server for the MedData API: drug and supplement lookup and interaction checks from free U.S. government health databases.

Project description

MedData MCP Server

mcp-name: io.github.anthesiallc/meddata

A Model Context Protocol server that exposes the MedData API as tools, so any MCP client (Claude Desktop, Cursor, ChatGPT connectors, or an agent framework) can look up drug and supplement data and check interactions conversationally.

It's a thin wrapper: each tool maps to one MedData REST endpoint. All the data work happens in the API.

Tools

Tool What it does
search_drugs Search drugs by brand or generic name; returns RxCUI + details
get_drug Full drug profile by RxCUI
get_drug_by_ndc Drug profile by NDC package code
search_supplements Search supplements by name; returns supplement IDs
get_supplement Full supplement fact sheet by ID
check_interactions Interactions across a mixed list of 2-10 drugs/supplements
get_usage Current billing period usage and plan limit

Get an API key

Free tier is 250 calls/month, no credit card:

curl -X POST https://meddata.anthesia.io/api/v1/signup \
  -H 'Content-Type: application/json' \
  -d '{"email":"you@example.com"}'

The key comes back in the api_key field of the response.

Install and run

The easiest way is with uv (no manual venv needed):

# stdio transport (default — for Claude Desktop, Cursor, most local clients)
MEDDATA_API_KEY=md_your_key uvx meddata-mcp

# streamable-HTTP transport (for remote / web clients)
MEDDATA_API_KEY=md_your_key uvx meddata-mcp --http

Or install with pip into its own environment:

pip install meddata-mcp
MEDDATA_API_KEY=md_your_key meddata-mcp

Note: install into a dedicated environment. The mcp SDK requires a newer starlette than the MedData API app pins, so the two will conflict if installed together.

Environment variables:

  • MEDDATA_API_KEY (required) — your MedData API key.
  • MEDDATA_BASE_URL (optional) — defaults to https://meddata.anthesia.io.
  • MEDDATA_TIMEOUT (optional) — request timeout in seconds, default 30.

Client configuration

Claude Desktop

Add to claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "meddata": {
      "command": "uvx",
      "args": ["meddata-mcp"],
      "env": { "MEDDATA_API_KEY": "md_your_key" }
    }
  }
}

Cursor

Add the same block to ~/.cursor/mcp.json (or the project .cursor/mcp.json).

Develop from source

cd mcp_server
python -m venv .venv
.venv/Scripts/python -m pip install -e .   # Windows
# .venv/bin/pip install -e .                # macOS/Linux
MEDDATA_API_KEY=md_your_key .venv/Scripts/python -m meddata_mcp.server

Notes

  • Data is for informational purposes only and is not medical advice.
  • Interaction data comes from established medical databases; an empty result means none were found in those sources, not that a combination is proven safe.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

meddata_mcp-0.2.0.tar.gz (7.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

meddata_mcp-0.2.0-py3-none-any.whl (9.0 kB view details)

Uploaded Python 3

File details

Details for the file meddata_mcp-0.2.0.tar.gz.

File metadata

  • Download URL: meddata_mcp-0.2.0.tar.gz
  • Upload date:
  • Size: 7.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.14

File hashes

Hashes for meddata_mcp-0.2.0.tar.gz
Algorithm Hash digest
SHA256 8f9dcc435acbaa5e68cf9c24c4b7c5f46d3f46f171c9831ded39f39c694e1918
MD5 149114f89640842bc0e08615511f1369
BLAKE2b-256 9d17d1913ad4509e28c99f041338750cda7cb2759e082670272a1b0a4d0ffc0d

See more details on using hashes here.

File details

Details for the file meddata_mcp-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: meddata_mcp-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 9.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.14

File hashes

Hashes for meddata_mcp-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2780090175575fd947ebf979a33dcce37e235cdbf9ac99d138fd041c6533b75c
MD5 e0b94b9b12d9e6e264b340e5bf4fc642
BLAKE2b-256 b7be895e1c6570362f2fdef42609b49314f0fbe08c5f943086ffe6fdd403dc0c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page