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.

The public business site at pharmagenai.github.io is the external product and company overview. Technical installation, capability, testing, and release documentation for operators and maintainers lives in this repository under docs/ and the capability cookbooks, alongside the source code.

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	16	Create, validate, render, and export 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

Architecture diagram

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 supports Claude Code, Codex, and GitHub Copilot CLI. It requires uv/uvx and 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

Public business site for external product and company overview
Technical documentation in this repository for installation, capability, testing, and release instructions
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.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for open-pharma-plugins 2.4.0
File	Size	Uploaded
open_pharma_plugins-2.4.0.tar.gz	729.6 kB	Aug 30, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for open-pharma-plugins 2.4.0
File	Interpreter	ABI	Platform	Reset
open_pharma_plugins-2.4.0-py3-none-any.whl 793.7 kB Aug 30, 2026	Python 3	none	any	Details

Total release size: 1.5 MB

Release files / open_pharma_plugins-2.4.0.tar.gz

Download URL	open_pharma_plugins-2.4.0.tar.gz
Size	729.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`2986bb4e452b09b5db312c0b08c6bc7e61fe56e71dce4571064370ff92420584`
BLAKE2b-256 checksum How to use checksums	`13243f6e70fb33f10d7918601d8b85c02f0a4fa3a4635519b5ed41646235a1bc`
Upload date	Aug 30, 2026
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.4.0-py3-none-any.whl

Download URL	open_pharma_plugins-2.4.0-py3-none-any.whl
Size	793.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`edea43c19f0c0d7c1cf74b7a991b9f56b40562383df24732904aa82ed5be6069`
BLAKE2b-256 checksum How to use checksums	`5b7a977c527fff9803646ff0a45a8de46ce918fad20aa3fbd8aac9702acc9f25`
Upload date	Aug 30, 2026
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}`