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.1.0.tar.gz (5.8 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.1.0-py3-none-any.whl (6.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: meddata_mcp-0.1.0.tar.gz
  • Upload date:
  • Size: 5.8 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.1.0.tar.gz
Algorithm Hash digest
SHA256 bae2cd13969aa6a81e0c8190d4054e24fe7e65d8507b0df9a992cbd28cb7ef64
MD5 615f5e9ef0a7ce13ecb8e3df363dc42b
BLAKE2b-256 52aa28d71d30d360e37597d5e77ca1b25b0c6dca78360a79576b272b690f85d7

See more details on using hashes here.

File details

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

File metadata

  • Download URL: meddata_mcp-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 6.7 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.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2ea1312609ffd3376664bba8b8eebef883f02bbde3f6d5f7a6c221437123502b
MD5 76c8dfdc3f8461081b025442754b357a
BLAKE2b-256 df65a433f5a2902633e554f61e182ac38d14c0d45053a39752615fcd1b6b8757

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