Adaptyv Bio Foundry API
A reference skill for designing, submitting, and retrieving protein experiments through the Adaptyv Foundry API and Python SDK.
Web & APIIntermediate★ 33,030⑂ 3,248AI score 8/10Last updated: Aug 9, 2026
What it does
Adaptyv Bio is a cloud lab: you submit amino acid sequences, its automated facility runs assays (binding, thermostability, expression, fluorescence) and returns data in roughly 21 days. This skill gives Claude the operational knowledge to drive that platform correctly:
- Authentication with Bearer tokens, reading
ADAPTYV_API_KEYfrom env or.env(never hardcoding secrets) - Both usage patterns: the
@lab.experimentdecorator and theFoundryClientobject - Experiment type matrix (affinity, screening, thermostability, expression, fluorescence) with required BLI/SPR methods and whether a target is needed
- The full status lifecycle from
DrafttoDone, including who must act at each stage - Sequence formats (simple, rich with metadata, multi-chain via colon), plus pagination, s-expression
filtersyntax andsortexpressions - Error handling via
request_id, and Biscuit token attenuation/revocation
Who it's for
- Protein designers who want wet-lab validation of de novo binders, scFvs or antibodies
- ML engineers wiring an automated submission step onto an AI protein design pipeline
- Teams with an existing Adaptyv Foundry account managing many experiments programmatically
Examples
- "Submit my 20 EGFR binder candidates for BLI screening, show the cost first" → target lookup,
cost_estimate,create(Draft), thensubmit. - "Make this hands-off" → generates a pipeline using
skip_draft,auto_accept_quoteand awebhook_urlthat fires on every status transition. - "List experiments finished this year, newest first" → builds
filter=and(gte(created_at,2026-01-01),eq(status,done))&sort=desc(created_at)and fetches results.
· · · Install guide · · ·
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the skills/adaptyv folder from the GitHub repo K-Dense-AI/scientific-agent-skills into my ~/.claude/skills/adaptyv/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git /tmp/scientific-agent-skills && mkdir -p ~/.claude/skills && cp -r /tmp/scientific-agent-skills/skills/adaptyv ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal and clone the repo:
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git - Copy the skill into your Claude skills folder:
mkdir -p ~/.claude/skills && cp -r scientific-agent-skills/skills/adaptyv ~/.claude/skills/ - Confirm the bundled
references/api-endpoints.mdfile came along (it documents all 32 endpoints). - Grab an API key from the sidebar at foundry.adaptyvbio.com.
- Create a
.envin your project root containingADAPTYV_API_KEY=your_key, and add.envto.gitignore. - On Python 3.10+, install the SDK:
uv pip install "git+https://github.com/adaptyvbio/adaptyv-sdk.git" - Restart Claude Code and try: "Create an EGFR binding screen on Adaptyv" — the skill triggers automatically.
View source on GitHub ↗License: MIT