[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [FDA Purple Book biologic records](https://spiral.ai/integrations/codex/fda-purple-book-biologic-records)

# How to Use FDA Purple Book biologic records in Codex

Returns FDA biologic licensing records, including approval dates, applicants, exclusivity dates, and biosimilar or interchangeable relationships. Use it to investigate a reference product such as Humira or research biologics beyond cell and gene therapies.

|  |  |
| --- | --- |
| Model | FDA Purple Book biologic records |
| Available through | Alexandria |
| Category | Health |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with FDA Purple Book biologic records in Codex

- Use FDA Purple Book biologic records to find products referencing Humira and generate a table in our project showing their names, applicants, and license classifications.
- Use FDA Purple Book biologic records to retrieve BLA 125057 and reconcile the returned product names and applicant against our existing research dataset.
- Use FDA Purple Book biologic records to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from FDA Purple Book biologic records and tell me what changed since last week.
- Check FDA Purple Book biologic records and summarize what you find in three bullet points.

## How to set up FDA Purple Book biologic records in Codex

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
codex mcp add spiral --url https://api.spiral.ai/mcp
```

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run FDA Purple Book biologic records**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "fda-gov/biologics/purple_book",
    "input": {
      "name": "<name>"
    }
  }'
```

Then paste one of the prompts above: Codex finds FDA Purple Book biologic records on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/codex

## FDA Purple Book biologic records tools and prices

- [FDA · Purple book](https://spiral.ai/tools/alexandria/fda-gov/biologics/purple_book) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| name |  | — | Proper or proprietary name words, e.g. adalimumab or Humira. |
| skip | 0 to 5000 | 0 | skip |
| limit | 1 to 100 | 10 | limit |
| center | CDER, CBER | — | center |
| applicant |  | — | Applicant name words, e.g. Amgen. |
| bla_number |  | — | BLA number, e.g. 125057 or BLA 125057. |

## What can you do with FDA Purple Book biologic records in Codex?

Build an FDA approval reference table in your project from returned product names, applicants, and dates. A coding agent can reconcile those records with an existing research file and keep approval dates separate from exclusivity dates.

### Compare approved cell and gene therapies

Build a comparison of Casgevy, Lyfgenia, and Zynteglo using their returned proper names, applicants, approval dates, and reported exclusivity dates.

### Create an approval timeline

Arrange returned cell and gene therapy approvals by date for a research brief. Keep the original approval date separate from first licensure and exclusivity expiration.

### Check a company's approved therapy inventory

Review returned applicants and product names for a company such as Kite Pharma. Use the records to support an inventory of licensed therapies.

### Prepare an exclusivity review

Collect reported exclusivity dates for named therapies before a regulatory research meeting. Flag records requiring further investigation when first-licensure information is absent.

### Reconcile product names in research

Match brand names such as Zolgensma to the proper names returned by FDA records. Add the reported applicant and approval date to a research reference table.

### Review changes to published approval records

Compare successive retrievals for a watchlist of approved therapies. Produce a review queue when returned product names, applicants, or reported exclusivity dates change.

### Map biosimilar competition

Find records referencing Humira or Stelara and organize the returned products by biosimilar or interchangeable license classification.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Codex guides](https://spiral.ai/integrations/codex)

## FDA Purple Book biologic records in other agents

- [Amp](https://spiral.ai/integrations/amp/fda-purple-book-biologic-records)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/fda-purple-book-biologic-records)
- [Claude](https://spiral.ai/integrations/claude-desktop/fda-purple-book-biologic-records)
- [Claude Code](https://spiral.ai/integrations/claude-code/fda-purple-book-biologic-records)
- [Cline](https://spiral.ai/integrations/cline/fda-purple-book-biologic-records)
- [Cursor](https://spiral.ai/integrations/cursor/fda-purple-book-biologic-records)
- [Devin](https://spiral.ai/integrations/devin/fda-purple-book-biologic-records)
- [dots](https://spiral.ai/integrations/dots/fda-purple-book-biologic-records)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/fda-purple-book-biologic-records)
- [Gemini](https://spiral.ai/integrations/gemini/fda-purple-book-biologic-records)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/fda-purple-book-biologic-records)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/fda-purple-book-biologic-records)
- [goose](https://spiral.ai/integrations/goose/fda-purple-book-biologic-records)
- [Grok](https://spiral.ai/integrations/grok/fda-purple-book-biologic-records)
- [Grok Build](https://spiral.ai/integrations/grok-build/fda-purple-book-biologic-records)
- [Hermes](https://spiral.ai/integrations/hermes/fda-purple-book-biologic-records)
- [Instinct](https://spiral.ai/integrations/instinct/fda-purple-book-biologic-records)
- [Manus](https://spiral.ai/integrations/manus/fda-purple-book-biologic-records)
- [Muse](https://spiral.ai/integrations/muse/fda-purple-book-biologic-records)
- [Muse Code](https://spiral.ai/integrations/muse-code/fda-purple-book-biologic-records)
- [n8n](https://spiral.ai/integrations/n8n/fda-purple-book-biologic-records)
- [Notion](https://spiral.ai/integrations/notion/fda-purple-book-biologic-records)
- [OpenClaw](https://spiral.ai/integrations/openclaw/fda-purple-book-biologic-records)
- [opencode](https://spiral.ai/integrations/opencode/fda-purple-book-biologic-records)
- [Perplexity](https://spiral.ai/integrations/perplexity/fda-purple-book-biologic-records)
- [Raycast](https://spiral.ai/integrations/raycast/fda-purple-book-biologic-records)
- [VS Code](https://spiral.ai/integrations/vscode/fda-purple-book-biologic-records)
- [Windsurf](https://spiral.ai/integrations/windsurf/fda-purple-book-biologic-records)
- [Zapier](https://spiral.ai/integrations/zapier/fda-purple-book-biologic-records)

## More Codex guides

- [FDA Paragraph IV patent certifications](https://spiral.ai/integrations/codex/fda-paragraph-iv-patent-certifications)
- [FDA cell and gene therapy approvals](https://spiral.ai/integrations/codex/fda-cell-and-gene-therapy-approvals)
- [FDA Orange Book drug records](https://spiral.ai/integrations/codex/fda-orange-book-drug-records)
- [FDA complete response letter details](https://spiral.ai/integrations/codex/fda-complete-response-letter-details)
- [FDA NDC drug listings](https://spiral.ai/integrations/codex/fda-ndc-drug-listings)
- [FDA complete response letter search](https://spiral.ai/integrations/codex/fda-complete-response-letter-search)

## Questions about FDA Purple Book biologic records in Codex

**Can Codex use FDA Purple Book biologic records?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run FDA Purple Book biologic records like any built-in tool.

**How much does FDA Purple Book biologic records cost in Codex?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.

**Do I need an Alexandria account to use FDA Purple Book biologic records in Codex?**

No. Spiral runs FDA Purple Book biologic records on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up FDA Purple Book biologic records in Codex?**

About two minutes: add the hosted server, then sign in.

**Does Codex wait while FDA Purple Book biologic records runs?**

FDA Purple Book biologic records runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

**Which biologics does the FDA source cover?**

The Purple Book covers FDA-approved CDER biologics, including biosimilars and interchangeable products. Its CBER coverage includes cell and gene therapies, vaccines, allergenic products, and hematologic products.

**How quickly does FDA publish approvals and changes?**

FDA says approved biologics and updates to approved product information generally enter the Purple Book within 10 business days of approval. That timing describes FDA's database publication.

**Does a missing first-licensure date mean there is no exclusivity?**

No. FDA has not determined first licensure for every 351(a) product, and explicitly says an absent date does not establish that the product is ineligible for exclusivity.

**Does FDA provide historical snapshots?**

Yes. FDA publishes monthly Purple Book reports whose bottom section contains the complete database for that month, allowing comparisons with earlier published records.

**Can I search using a scientific name instead of a brand?**

Yes. FDA supports both proprietary brand names and nonproprietary proper names in Purple Book searches, which helps when a research document uses a different name for the same biologic.

