Cortellis MCP Server

by MCP-Mirror

231 downloads Not rated yet MIT license
GitHub

About

An MCP server that provides tools to search for drugs, explore ontology terms, and retrieve detailed drug, company, and deal records from the Cortellis database. It requires valid Cortellis API credentials and is intended for developers and researchers working with…

Details

License
MIT license

Explore

- Direct access to Cortellis drug and deal database
- Comprehensive drug and deal development status search
- Ontology/taxonomy term exploration
- Detailed drug and deal information retrieval
- SWOT analysis for drugs
- Financial data and forecasts
- Structured JSON responses
- Pagination support for large result sets

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Cortellis MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository


The server requires Cortellis API credentials:

env
CORTELLIS_USERNAME=your_username
CORTELLIS_PASSWORD=your_password

Before starting make sure Node.js is installed on your desktop for npx to work.
1. Go to: Settings > Developer > Edit Config

2. Add the following to your claude_desktop_config.json:

json
{
"mcpServers": {
"cortellis": {
"command": "npx",
"args": [
"-y",
"@uh-joan/cortellis-mcp-server"
],
"env": {
"CORTELLIS_USERNAME": "your_username",
"CORTELLIS_PASSWORD": "your_password"
}
}
}
}
```

3. Restart Claude Desktop and start exploring drug development data!

cp .env.example .env

query

(string) - Raw search query

company

(string) - Company ID for the developing company (e.g., "18614")

indication

(string) - Indication ID (numeric ID only, e.g., "238" for Obesity). Use explore_ontology to find the correct ID.

action

(string) - Target specific action (e.g., glucagon)

phase

(string) - Development status:

phase_terminated

(string) - Last phase before NDR/DX

technology

(string) - Drug technology (e.g., small molecule)

drug_name

(string) - Name of the drug

country

(string) - Country ID (e.g., "US")

offset

(number) - For pagination

company_size

(string) - The size of a company based on market capitalization in billions USD

developmentStatusDate

(string) - Date of change in status (only possible within LINKED queries). Use RANGE(>=YYYY-MM-DD;<=YYYY-MM-DD) for ranges. Example: `RANGE(>=2023-01-01;<=2023-12-31)`

historic

(boolean) - **Set to true to search using the historic development status fields. This is required for questions about the status of a drug at a specific point in the past (e.g., 'What drugs were in phase 3 in 2019?'). If you want to know the status as it was at a particular date or within a date range, always set historic: true and use the developmentStatusDate parameter.**

term

(string) - Generic search term

category

(string) - Category to search within

target

(string) - Drug target

id

(string) - Numeric Drug Identifier (e.g. "101964" for tirzepatide, not the drug name)

company_name

(string) - Company name to search for

hq_country

(string) - Company headquarters country

deals_count

(string) - Count for all distinct deals where company is principal/partner

indications

(string) - Top 10 indication terms

actions

(string) - Top 10 target-based action terms

technologies

(string) - Top 10 technologies terms

status

(string) - Highest status of linked drugs

dealDrugNamesAll

(string) - Main name of drug including synonyms associated with the deal

dealDrugCompanyPartnerIndications

(string) - The indication and the partner company linked to a drug associated with the deal

dealPhaseHighestStart

(string) - Highest dev. status of the drug at the deal start

dealPhaseHighestNow

(string) - Current highest dev. status of the drug

dealStatus

(string) - Status of the deal

dealSummary

(string) - Summary of the deal

dealTitleSummary

(string) - Title or summary of the deal

dealTitle

(string) - Title of the deal

dealType

(string) - Type of deal

actionsPrimary

(string) - Primary mechanism of action associated with the deal

sortBy

(string) - Sort order for results. Use '+field' for ascending or '-field' for descending. Supported fields: dealDateStart, dealDateEnd, dealDateEventMostRecent, dealTotalPaidSortBy, dealTotalProjectedCurrentSortBy, dealValuePaidToPrincipalMaxSortBy, dealValueProjectedToPrincipalMaxSortBy. Example: '+dealDateStart' for oldest first, '-dealDateStart' for newest first. Useful for queries like 'last 10 deals for a company'.

1. search_drugs
- Search for drugs in the Cortellis database
- Optional Inputs:
- query (string) - Raw search query
- company (string) - Company ID for the developing company (e.g., "18614")
- indication (string) - Indication ID (numeric ID only, e.g., "238" for Obesity). Use explore_ontology to find the correct ID.
- action (string) - Target specific action (e.g., glucagon)
- phase (string) - Development status:
- Uses LINKED format with short codes: S, DR, CU, C1-C3, PR, R, L, OL, NDR, DX, W
- Important: only a single phase value is supported for the phase parameter; do not use OR/AND. If you need to search for multiple phases, run separate queries for each phase.
- Examples:
- phase: "L"
- phase: "C1"
- phase: "C2"
- phase: "C3"
- Status codes:
- S: Suspended
- DR: Discovery/Preclinical
- CU: Clinical (unknown phase)
- C1-C3: Phase 1-3 Clinical
- PR: Pre-registration
- R: Registered
- L: Launched
- OL: Outlicensed
- NDR: No Development Reported
- DX: Discontinued
- W: Withdrawn
- phase_terminated (string) - Last phase before NDR/DX
- Uses short format with double colon: S, DR, CU, C1-C3, PR, R, L, OL, NDR, DX, W
- Supports AND/OR operators
- Examples:
- phase_terminated: "C2"
- phase_terminated: "C2 OR C3"
- technology (string) - Drug technology (e.g., small molecule)
- drug_name (string) - Name of the drug
- country (string) - Country ID (e.g., "US")
- offset (number) - For pagination
- company_size (string) - The size of a company based on market capitalization in billions USD
- Format: '<X' for less than $XB, 'X' for greater than $XB
- developmentStatusDate (string) - Date of change in status (only possible within LINKED queries). Use RANGE(>=YYYY-MM-DD;<=YYYY-MM-DD) for ranges. Example: RANGE(>=2023-01-01;<=2023-12-31)
- historic (boolean) - Set to true to search using the historic development status fields. This is required for questions about the status of a drug at a specific point in the past (e.g., 'What drugs were in phase 3 in 2019?'). If you want to know the status as it was at a particular date or within a date range, always set historic: true and use the developmentStatusDate parameter.
- Returns: JSON response with drug information and development status

2. explore_ontology
- Explore taxonomy terms in the Cortellis database
- Optional Inputs (at least one required):
- term (string) - Generic search term
- category (string) - Category to search within
- action (string) - Target specific action
- indication (string) - Disease/condition
- company (string) - Company name
- drug_name (string) - Drug name
- target (string) - Drug target
- technology (string) - Drug technology
- Returns: JSON response with matching taxonomy terms

3. get_drug
- Return the entire drug record with all available fields for a given identifier
- Required Input:
- id (string) - Numeric Drug Identifier (e.g. "101964" for tirzepatide, not the drug name)
- Example:
{
"tool-name": "get_drug",
"Tool_Parameters": {
"id": "101964"
}
}
- Returns: JSON response with complete drug record

4. get_drug_swot
- Return SWOT analysis complementing chosen drug record
- Required Input:
- id (string) - Numeric Drug Identifier (e.g. "101964" for tirzepatide, not the drug name)
- Example:
{
"tool-name": "get_drug_swot",
"Tool_Parameters": {
"id": "101964"
}
}
- Returns: JSON response with SWOT analysis for the drug

5. get_drug_financial
- Return financial commentary and data (actual sales and consensus forecast)
- Required Input:
- id (string) - Numeric Drug Identifier (e.g. "101964" for tirzepatide, not the drug name)
- Example:
{
"tool-name": "get_drug_financial",
"Tool_Parameters": {
"id": "101964"
}
}
- Returns: JSON response with financial data and commentary

6. get_company
- Return the entire company record with all available fields for a given identifier
- Required Input:
- id (string) - Numeric Company Identifier (not the company name)
- Example:
{
"tool-name": "get_company",
"Tool_Parameters": {
"id": "12345"
}
}
- Returns: JSON response with complete company record

7. search_companies
- Search for companies in the Cortellis database
- Optional Inputs:
- query (string) - Raw search query
- company_name (string) - Company name to search for
- hq_country (string) - Company headquarters country
- deals_count (string) - Count for all distinct deals where company is principal/partner
- Format: '<20' for less than 20 deals
- Format: '20' or '>20' for greater than 20 deals (default behavior)
- indications (string) - Top 10 indication terms
- actions (string) - Top 10 target-based action terms
- technologies (string) - Top 10 technologies terms
- company_size (string) - The size of a company based on market capitalization in billions USD
- Format: '<2' for less than $2B
- Format: '2' or '>2' for greater than $2B (default behavior)
- status (string) - Highest status of linked drugs
- offset (number) - For pagination
- Returns: JSON response with company information

8. search_deals
- Search for deals in the Cortellis database
- Optional Inputs:
- query (string) - Raw search query (if you want to use the full Cortellis query syntax directly)
- dealDrugNamesAll (string) - Main name of drug including synonyms associated with the deal
- indications (string) - Indications associated with the deal
- dealDrugCompanyPartnerIndications (string) - The indication and the partner company linked to a drug associated with the deal
- dealPhaseHighestStart (string) - Highest dev. status of the drug at the deal start
- dealPhaseHighestNow (string) - Current highest dev. status of the drug
- dealStatus (string) - Status of the deal
- dealSummary (string) - Summary of the deal
- dealTitleSummary (string) - Title or summary of the deal
- technologies (string) - Technology linked to the drug
- dealTitle (string) - Title of the deal
- dealType (string) - Type of deal
- actionsPrimary (string) - Primary mechanism of action associated with the deal
- sortBy (string) - Sort order for results. Use '+field' for ascending or '-field' for descending. Supported fields: dealDateStart, dealDateEnd, dealDateEventMostRecent, dealTotalPaidSortBy, dealTotalProjectedCurrentSortBy, dealValuePaidToPrincipalMaxSortBy, dealValueProjectedToPrincipalMaxSortBy. Example: '+dealDateStart' for oldest first, '-dealDateStart' for newest first. Useful for queries like 'last 10 deals for a company'.
- offset (number) - For pagination
- Returns: JSON response with deal information

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "cortellis mcp server": {
            "uh-joan_cortellis-mcp-server": {
                "command": "npx",
                "args": [
                    "cortellis-mcp-server"
                ]
            }
        }
    }
}

McpServers

{
    "uh-joan_cortellis-mcp-server": {
        "command": "npx",
        "args": [
            "cortellis-mcp-server"
        ]
    }
}

MCP Server for searching drugs and exploring ontology terms in the Cortellis database.

Installation

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.