mcp-cortellis

# Cortellis MCP Server <!-- Project Status --> [](https://opensource.org/licenses/MIT) [](https://pypi.org/project/cortellis-mcp/) [](https://www.python.org/downloads/) [](CONTRIBUTING.md) An MCP server enabling AI assistants to search and analyze pharmaceutical data through Cortellis. Perfect for competitive intelligence and pharmaceutical market research. ## Features - 🔍 **Drug Search**: Search by indication, phase, company, and development status - 🧬 **Ontology Exploration**: Navigate standardized medical terminology and drug classifications - 🛠 **Developer-Friendly**: Clear documentation and easy integration with AI assistants - 🔐 **Secure Authentication**: Base64 token-based authentication for API access ## Quick Start ### Installation ```bash # Using pip pip install cortellis-mcp # Or for development git clone https://github.com/uh-joan/mcp-cortellis.git cd mcp-cortellis python -m venv venv source venv/bin/activate # On Unix/macOS pip install -e . ``` ### Authentication Setup The server uses a base64-encoded authentication token that combines your Cortellis username and password in the format `username:password`. This token must be provided in the `CORTELLIS_AUTH` environment variable. To generate your token: ```bash # On Unix/macOS echo -n "your_username:your_password" | base64 # On Windows PowerShell [Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("your_username:your_password")) ``` Set up your environment: 1. Copy `.env.example` to `.env` 2. Replace `your_base64_token` with your generated token: ```bash # In .env file CORTELLIS_AUTH=your_base64_token # e.g., dXNlcm5hbWU6cGFzc3dvcmQ= MCP_WEBSOCKET=true MCP_PORT=8765 ``` ### IDE Integration ```json { "mcps": { "cortellis": { "command": ["python"], "args": ["-m", "cortellis_mcp"], "env": { "CORTELLIS_AUTH": "your_base64_token", "MCP_WEBSOCKET": "true", "MCP_PORT": "8765" } } } } ``` ## Usage ### Development Status Codes - `DR`: Discovery/Preclinical - `C1`: Phase 1 Clinical - `C2`: Phase 2 Clinical - `C3`: Phase 3 Clinical - `PR`: Pre-registration - `R`: Registered - `L`: Launched - `DX`: Discontinued - `W`: Withdrawn ### Example Queries - "Search for drugs targeting obesity in phase 3" - "Find all launched drugs by Novo Nordisk" - "Explore ontology terms related to glucagon" ### Python API ```python from cortellis_mcp import search_drugs, explore_ontology # Search for Phase 3 obesity drugs results = search_drugs( indication="obesity", phase="C3" ) # Explore ontology terms terms = explore_ontology( category="indication", term="diabetes" ) ``` ## Documentation - [API Reference](docs/API.md) - [Example Scripts](examples/) - [Contributing Guidelines](CONTRIBUTING.md) - [License](LICENSE) ## Security - Token-based authentication using base64 encoded credentials - HTTPS encryption for API communications - Request validation and rate limiting - Regular security audits - Secure environment variable handling ## Support For issues and feature requests, please use the [GitHub issue tracker](https://github.com/uh-joan/mcp-cortellis/issues).