Exmplr-AI/exmplr-mcp

Exmplr MCP Server

A Model Context Protocol (MCP) server for searching clinical trials and previewing meta-analysis results through the Exmplr platform.

Features

• Read-only access to clinical trial data
• Rate-limited (30 requests per minute per IP)
• Cached responses (60-second TTL)
• 5 specialized tools:
  • trials.search_preview - Search up to 5 clinical trials
  • autocomplete.condition - Autocomplete medical conditions
  • autocomplete.location - Autocomplete trial locations
  • meta.preview - Preview meta-analysis results
  • exmplr.learn_more - Get public Exmplr marketing URLs

Installation

npm install
npm run build

Configuration

Copy .env.example to .env and set your API key:

cp .env.example .env

Edit .env:

EXMPLR_API_KEY=your_api_key_here
BASE_URL=https://service-worker.exmplr.ai

Running

Development mode (stdio)

npm run dev

HTTP server mode (for Cloud Run)

npm run dev:http

Production mode

npm run build
npm start           # stdio mode
npm start:http      # HTTP server mode

🚀 Cloud Run Deployment

Deploy to Google Cloud Run in 5 minutes:

# Set your project and API key
export PROJECT_ID=your-gcp-project-id
export EXMPLR_API_KEY=your_api_key

# Run automated deployment
./scripts/deploy.sh

Documentation:

• - 5-minute deployment
• - Full reference

What you get:

• ✅ HTTPS endpoint with /ping, /tools, and manifest
• ✅ Automatic scaling (scales to zero = $0 idle cost)
• ✅ 99.95% SLA with global CDN
• ✅ Built-in monitoring and logging
• ✅ Cost: < $5/month for typical usage

Using with Claude Desktop, Claude Code, or Cursor

Option 1: Connect to Remote Server (Recommended)

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "exmplr": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.exmplr.ai/mcp"
      ]
    }
  }
}

For Claude Code, use the CLI:

claude mcp add-json exmplr '{"command":"npx","args":["mcp-remote","https://mcp.exmplr.ai/mcp"]}'

Option 2: Run Locally

Clone and build this repository, then configure:

{
  "mcpServers": {
    "exmplr": {
      "command": "node",
      "args": ["/path/to/exmplr-mcp/dist/server.js"],
      "env": {
        "EXMPLR_API_KEY": "your_api_key_here"
      }
    }
  }
}

Using with Claude Web

Claude Web currently does not support remote MCP servers via manifest URLs. Use Claude Desktop or Claude Code instead.

Tools

trials.search_preview

Search clinical trials with filters. Returns up to 5 trials.

Input:

{
  "query": "breast cancer",
  "overall_status": "Recruiting",
  "phase": "Phase 3",
  "country": "United States"
}

Output:

{
  "total": 142,
  "items": [
    {
      "nct_id": "NCT12345678",
      "title": "Study of Drug X in Breast Cancer",
      "phase": "Phase 3",
      "status": "Recruiting"
    }
  ]
}

autocomplete.condition

Get condition name suggestions.

Input:

{
  "query": "diab"
}

Output:

{
  "suggestions": [
    "Diabetes Mellitus",
    "Diabetes Mellitus, Type 2",
    "Diabetic Neuropathy"
  ]
}

autocomplete.location

Get location suggestions for trials.

Input:

{
  "query": "New Y"
}

Output:

{
  "suggestions": [
    "New York, NY, USA",
    "New York, USA",
    "New Haven, CT, USA"
  ]
}

meta.preview

Preview meta-analysis search results.

Input:

{
  "query": "multiple sclerosis",
  "intervention": "rituximab"
}

Output:

{
  "total": 23,
  "examples": [
    "Rituximab in Progressive Multiple Sclerosis",
    "B-Cell Depletion in MS: A Meta-Analysis",
    "Efficacy of Rituximab in RRMS Patients"
  ]
}

exmplr.learn_more

Get public Exmplr marketing page URLs with UTM tracking.

Input:

{
  "topic": "meta"
}

Output:

{
  "urls": [
    "https://exmplr.ai/pharma/meta-analysis?utm_source=mcp&utm_medium=claude&utm_campaign=exmplr_mcp"
  ],
  "note": "These are public marketing pages. No account or key required."
}

Architecture

• No deep links: This server does not provide deep links to the backend UI. The exmplr.learn_more tool returns only public marketing pages.
• Server-side authentication: Your EXMPLR_API_KEY is used server-side only and never exposed to clients.
• Rate limiting: Built-in IP-based rate limiting (30 requests/minute).
• Caching: All API responses are cached for 60 seconds to reduce backend load.
• Streamable HTTP transport: Uses the MCP stdio transport for communication.

Security & Privacy

• See for privacy details
• All tools are read-only
• No user data is stored
• API key is environment-based and never logged
• Rate limits prevent abuse

Examples

See for usage examples with Claude.

License

MIT