Open Pharma Plugins
Agent Skills and MCP tools for pharmaceutical commercial operations.
Public beta. Validate outputs before operational use. Campaign and field-training artifacts are drafts for qualified medical/legal/regulatory review, not automated approval.
Capabilities
| Capability | Tools | Description |
|---|---|---|
| HCP Intelligence | 11 | Build evidence-backed HCP/HCO profiles from public sources |
| Field Training | 5 | Turn approved PDF/PPTX paths into grounded learning packages, assessments, role-play kits, and scorecards |
| Campaign Studio | 11 | Create, validate, render, and package campaign drafts for MLR review |
| Next-Best-Engagement | 3 | Score HCPs and produce consent-aware engagement plans |
| Territory Alignment | 6 | Compare HCP-to-rep assignments and plan visit clusters |
| Competitive Intelligence | 12 | Collect one evidence run and project reproducible briefings and timelines |
Architecture
Each source plugin bundles a Skill with one MCP server. The Python wheel contains the six MCP servers and their runtime fixtures; Skills, cookbooks, and marketplace manifests are installed from the repository rather than the wheel.
Quick start
Python 3.10–3.13 is supported. Install one or more MCP servers from the published distribution:
python -m pip install "open-pharma-plugins[territory-alignment,competitive-intelligence]"
open-pharma-plugins-territory-alignment --version
For the complete Skill + MCP plugin, download and inspect the guided installer before running it:
curl -fsSLO https://raw.githubusercontent.com/PharmaGenAI/open-pharma-plugins/main/install.sh
less install.sh
bash install.sh
The installer requires uv/uvx; it never installs a package manager on your behalf. See Installation for tag-pinned and source-checkout options.
Configuration and local data
Copy .env.example to ~/.open-pharma-plugins/config and set only the providers you use. Process environment variables take precedence. Mutable data defaults to private capability directories under ~/.open-pharma-plugins; files are written with mode 0600 and directories with 0700 where POSIX permissions are available.
Common settings include:
| Variable | Used by |
|---|---|
SERPER_API_KEY / TAVILY_API_KEY / EXA_API_KEY |
Web search |
OPENROUTER_API_KEY / OPENROUTER_BASE_URL |
Optional HCP batch profile synthesis |
NCBI_API_KEY |
PubMed |
OPENFDA_API_KEY |
openFDA |
OPEN_PHARMA_*_DIR |
Capability-specific mutable-data locations |
API keys are not persisted in competitive-intelligence cache metadata, evidence URLs, runs, or reports. Source queries are still sent to the selected external provider, so do not place secrets or unnecessary personal data in search terms. Reports and timelines can reuse one immutable run instead of repeating provider calls.
HCP batch extraction/synthesis defaults to high reasoning effort, a 120-second request timeout,
and zero SDK retries. An installed HCP plugin accepts user-supplied input/output paths through the
tag-pinned open-pharma-plugins-hcp-batch console and produces canonical account JSON,
batch_summary.csv, and batch_manifest.json. See the
HCP batch guide for dry-run, confirmation, provider, CSV, and resume rules.
Documentation
- Installation
- Configuration
- HCP batch processing and CSV review
- Data security and compliance boundaries
- Local development
- Testing
- Adding a capability
- Releasing
- Manual harness setup
- Chinese documentation · Japanese documentation
License
Apache-2.0. See LICENSE.
Release files for open-pharma-plugins 2.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| open_pharma_plugins-2.2.0.tar.gz | 213.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| open_pharma_plugins-2.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 487.3 kB
Release files / open_pharma_plugins-2.2.0.tar.gz
| Download URL | open_pharma_plugins-2.2.0.tar.gz |
|---|---|
| Size | 213.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3361b1cac3add4c4ac9d4644ee54adbb24b76c391871ff215519fdd68c17b6ee
|
|
BLAKE2b-256 checksum How to use checksums |
c4ae40359f798c6c54de5a37becfe5535befab7599b03a499f9dc9ee347b8a42
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / open_pharma_plugins-2.2.0-py3-none-any.whl
| Download URL | open_pharma_plugins-2.2.0-py3-none-any.whl |
|---|---|
| Size | 273.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0e10dcbaaa423937f0bca610a6c86088590b9e65633fccb466690cde8ed852cb
|
|
BLAKE2b-256 checksum How to use checksums |
e2fe36a16bd964199c8ee04fcb7ebe71c239b1dbc43e8014739c81f9409dce35
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|