home / mcp / fda taiwan drug mcp server

FDA Taiwan Drug MCP Server

Provides query, CAPTCHA handling, and PDF download services for Taiwan FDA drug information using MCP.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "benjamin920101-fda-taiwan-mcp": {
      "url": "https://mcp.fda.gov.tw/q_insert/qcase_01A1.asp"
    }
  }
}

You can query Taiwan FDA drug information, download official package inserts, and format results via a FastMCP server dedicated to Taiwan FDA drug data. It supports English-name searches, advanced multi-criteria lookups, CAPTCHA handling, single and batch PDF downloads, and convenient result formatting for analysis.

How to use

To get started, obtain a CAPTCHA image, recognize the 4-digit code, perform a drug search by English name, and then download the corresponding PDF inserts if available. You can also run advanced searches to combine multiple criteria and batch-download multiple inserts for efficiency.

How to install

Prerequisites: Python 3.10+ and the uvx package manager.

1. Clone or download the project directory to your workspace. 2. Start the MCP service which will automatically create a virtual environment and install dependencies by running the startup script.

3. Configure the MCP client to point at the local server instance.

Configuration and endpoints

API Endpoints:

- Query API (POST): https://mcp.fda.gov.tw/q_insert/qcase_01A1.asp

- CAPTCHA image (GET): https://mcp.fda.gov.tw/CheckCode.aspx

- PDF insert download (GET): https://mcp.fda.gov.tw/insert/pdfcasefile/{guid}

Usage examples

Example: obtain a CAPTCHA image, recognize the 4-digit code, search by English name, and download a PDF if available.

Troubleshooting and notes

Common issues include CAPTCHA errors (4-digit requirement) and network or download failures. If a download is not a valid PDF, verify the GUID. Practice sensible request delays to avoid service throttling.

Developer notes

The server supports core actions such as search by English name, advanced searches, CAPTCHA handling, and both single and batch PDF downloads. It also includes a tool to format search results for easier reading and analysis.

Available tools

search_drugs_by_english_name

Query drugs by English name keywords and retrieve detailed drug information including license numbers, Chinese and English names, applicant, and a GUID for the inserted package insert download.

advanced_drug_search

Perform multi-criteria searches using license number, Chinese name, English name, applicant, active ingredient, and other fields; supports fuzzy and partial matching and multiple conditions.

get_captcha_image

Fetch a 4-digit CAPTCHA image from the Taiwan FDA site, return Base64-encoded image data and a prompt for recognition, with support for re-fetching.

download_insert

Download the PDF package insert for a given drug GUID, verify integrity and format, and optionally save to a custom output path.

batch_download_inserts

Download multiple inserts in one operation, generate orderly filenames, and provide detailed download statistics.

format_search_results_tool

Transform raw query results into a structured, human-readable format for analysis and processing.