mcp-aitep

A CLI tool providing a Model Context Protocol (MCP) interface to retrieve PDE (Permitted Daily Exposure) reports for Active Pharmaceutical Ingredients (APIs) via AITEP.

Installation

npm install -g @kinginsun/mcp-aitep

Configuration

The server reads the API key from the AITEP_API_KEY environment variable. Configure it in whichever way your MCP host loads environment variables for stdio servers.

Apply for AITEP_API_KEY on the AITEP website

1. Open the AITEP portal: https://aitep.probot.hk.
2. Create an account if you do not have one: Register.
3. Sign in: Sign in.
4. After you are logged in, follow the on-site instructions to apply for or generate your API key, then copy it into your local configuration (see below). For general usage of the platform, see the User Guide.

Shell (current session)

export AITEP_API_KEY=your_api_key_here

Shell (persist in ~/.zshrc or ~/.bashrc)

echo 'export AITEP_API_KEY=your_api_key_here' >> ~/.zshrc
source ~/.zshrc

Cursor MCP (~/.cursor/mcp.json)

Replace the placeholder with your real key, or use a secret manager / env indirection supported by your setup.

{
  "mcpServers": {
    "aitep-pde": {
      "command": "npx",
      "args": ["-y", "@kinginsun/mcp-aitep"],
      "env": {
        "AITEP_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "aitep-pde": {
      "command": "npx",
      "args": ["-y", "@kinginsun/mcp-aitep"],
      "env": {
        "AITEP_API_KEY": "your_api_key_here"
      }
    }
  }
}

YAML-style host config (example)

If your client resolves ${AITEP_API_KEY} from the process environment, you can keep the secret out of the file and only reference the variable. Example (same idea as mcpServers.yaml in this repository):

version: 1
servers:
  aitep-pde:
    type: stdio
    command:
      args:
        - npx
        - "@kinginsun/mcp-aitep"
    env:
      AITEP_API_KEY: ${AITEP_API_KEY}

Usage

This tool provides a Model Context Protocol (MCP) interface for retrieving PDE reports for pharmaceutical ingredients. It can be used with any MCP-compatible client.

The tool provides the following capability:

AITEP_PDE_Report

Retrieves the PDE (Permitted Daily Exposure) report in JSON format for a given API (Active Pharmaceutical Ingredient).

Parameters:

• ingredient: (Required) Name of the active pharmaceutical ingredient

Example request payload:

{
  "ingredient": "Paracetamol"
}

Requirements

• Node.js >= 18.0.0
• Valid AITEP_API_KEY environment variable

test on commandline

echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"AITEP_PDE_Report","arguments":{"ingredient":"aspirin"}}}' | AITEP_API_KEY=api_key node dist/index.js

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | AITEP_API_KEY=api_key node dist/index.js

License

MIT