Metadata-Version: 2.4
Name: bioapi-sdk
Version: 0.1.0
Summary: Python SDK client for BioAPI genomics REST endpoints.
Author: omics-datascience
Project-URL: Homepage, https://bioapi.multiomix.org
Project-URL: Source, https://github.com/omics-datascience/BioAPI
Project-URL: Issues, https://github.com/omics-datascience/BioAPI/issues
Keywords: bioinformatics,genomics,gene-ontology,sdk
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Classifier: Typing :: Typed
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: requests<3,>=2.31.0
Provides-Extra: mcp
Requires-Dist: mcp<2,>=1.27; extra == "mcp"

# bioapi-sdk

Python SDK client for the BioAPI genomics REST service.

The distribution package is named `bioapi-sdk` and the import package is `bioapi_sdk`.

## Installation

```bash
pip install bioapi-sdk
```

## Usage

```python
from bioapi_sdk import gene_symbols, information_of_genes

symbols = gene_symbols(["ENSG00000141510", "7157"])
genes = information_of_genes(["TP53"])
```

By default, requests are sent to `https://bioapi.multiomix.org`. You can change
the server per call with `base_url=` or globally with the `BIOAPI_BASE_URL`
environment variable.

```python
from bioapi_sdk import gene_symbols

symbols = gene_symbols(["TP53"], base_url="http://localhost:5000")
```

## MCP server

The SDK package also includes a BioAPI MCP server for LLM clients. Install the MCP extra to include the MCP runtime dependency:

```bash
pip install "bioapi-sdk[mcp]"
```

After installation, run the server over stdio with:

```bash
bioapi-mcp
```

## Development

Build the package from this directory:

```bash
python -m build
```

The core SDK intentionally depends only on `requests` at runtime. The MCP server dependencies are installed only with the `mcp` extra.
