[Integrations](https://spiral.ai/integrations) › [Hermes](https://spiral.ai/integrations/hermes) › [AlphaFold predicted protein complexes](https://spiral.ai/integrations/hermes/alphafold-predicted-protein-complexes)

# How to Use AlphaFold predicted protein complexes in Hermes

Find predicted protein complexes containing your protein, with chain composition and interface confidence scores. Use these results to shortlist interaction hypotheses for research and compare assemblies beyond a single protein's fold.

|  |  |
| --- | --- |
| Model | AlphaFold predicted protein complexes |
| 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 AlphaFold predicted protein complexes in Hermes

- Every month, use AlphaFold predicted protein complexes for human TP53. Compare with the previous report and list newly returned complex identifiers.
- On the first Monday of each month, use AlphaFold predicted protein complexes for human EGFR. Report any changes in the returned interface confidence scores.
- Monthly, use AlphaFold predicted protein complexes for human BRCA1 and BARD1. Summarize newly returned assemblies and any changes to their protein compositions.
- Every month, use AlphaFold predicted protein complexes for P69905. Report whether the returned assemblies or their protein copy counts differ from the previous check.
- Monthly, use AlphaFold predicted protein complexes for human CD274. Tell me whether any newly returned predictions have interface confidence above 0.8.

## How to set up AlphaFold predicted protein complexes in Hermes

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

### Use the Spiral skill

1. **Send Hermes 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 Spiral's MCP server

1. **Add the server and sign in**: Hermes opens your browser: sign in to Spiral and click Authorize. No API key. When Hermes asks Enable all tools? \[Y/n/select], answer Y: n cancels without saving the server, and select hides the tools you leave out.

```bash
hermes mcp add spiral \
  --url https://api.spiral.ai/mcp \
  --auth oauth \
  --connect-timeout 300
```

2. **Check it**: In a chat that was already open, run `/reload-mcp`.

```bash
hermes mcp list
hermes mcp test spiral
```

### 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 AlphaFold predicted protein complexes**: 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": "alphafold-ebi-ac-uk/interactions/complexes",
    "input": {
      "id": "<id>"
    }
  }'
```

Then paste one of the prompts above: Hermes finds AlphaFold predicted protein complexes on Spiral, shows the price and runs it.

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

## AlphaFold predicted protein complexes tools and prices

- [AlphaFold Protein Structure Database · Complexes](https://spiral.ai/tools/alexandria/alphafold-ebi-ac-uk/interactions/complexes) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| id |  | — | UniProt accession (P04637), isoform (P04637-2), entry name (P53_HUMAN), AlphaFold DB model ID (AF-P04637-F1, AF-0000000000710001) or alphafold.ebi.ac.uk entry URL; case-insensitive. Exactly one of id and gene. |
| gene |  | — | Gene symbol (TP53, CD52, HLA-A), resolved to the one reviewed (Swiss-Prot) UniProt entry with that gene name, or that synonym, in organism. A symbol shared by several entries is invalid_input listing them. |
| limit | 1 to 100 | 25 | Most complexes to return, highest ipTM first. |
| min_iptm | 0 to 1 | — | Only complexes with ipTM at least this (0.8 keeps confident interfaces). |
| organism |  | — | Organism for gene: NCBI taxonomy ID (9606) or name (human, Mus musculus). Default 9606 (human). Only with gene. |

## What can you do with AlphaFold predicted protein complexes in Hermes?

Receive a monthly report of changes in the predicted complexes returned for your research targets. A scheduled agent can compare complex identifiers, chain compositions, and interface scores against its previous results.

### Prioritize interaction experiments

Retrieve complexes containing human TP53 and rank the returned assemblies by interface confidence to prepare a shortlist for experimental review.

### Compare predicted chain composition

Inspect the proteins and copy counts in returned assemblies to distinguish predicted self-association from complexes involving different proteins.

### Annotate a research target list

Add available complex identifiers, chain composition, and interface scores to a list of protein targets before choosing structures for closer review.

### Build a predicted interaction graph

Turn returned protein compositions into graph connections, retaining complex identifiers and confidence scores so researchers can inspect the underlying predictions.

### Watch for changes in available predictions

Repeat the same protein lookups monthly and compare saved results to identify newly returned complexes or changed interface scores.

### Prepare a structural biology lesson

Use returned assemblies to show how chain composition and interface confidence answer different questions about a predicted protein complex.

## Overview

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

## AlphaFold predicted protein complexes in other agents

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

## More Hermes guides

- [AlphaFold missense predictions](https://spiral.ai/integrations/hermes/alphafold-missense-predictions)
- [AlphaFold protein structure prediction](https://spiral.ai/integrations/hermes/alphafold-protein-structure-prediction)
- [mempool.space Transaction output spending status](https://spiral.ai/integrations/hermes/mempool-space-transaction-output-spending-status)
- [BDPM HAS medicine assessments](https://spiral.ai/integrations/hermes/bdpm-has-medicine-assessments)
- [mempool.space Recent Bitcoin blocks](https://spiral.ai/integrations/hermes/mempool-space-recent-bitcoin-blocks)
- [BDPM medicine details](https://spiral.ai/integrations/hermes/bdpm-medicine-details)

## Questions about AlphaFold predicted protein complexes in Hermes

**Can Hermes use AlphaFold predicted protein complexes?**

Yes. Add Spiral to Hermes as an MCP server, and Hermes can find and run AlphaFold predicted protein complexes like any built-in tool.

**How much does AlphaFold predicted protein complexes cost in Hermes?**

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

**Do I need an Alexandria account to use AlphaFold predicted protein complexes in Hermes?**

No. Spiral runs AlphaFold predicted protein complexes on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up AlphaFold predicted protein complexes in Hermes?**

About two minutes: add the server and sign in, then check it.

**Does Hermes wait while AlphaFold predicted protein complexes runs?**

AlphaFold predicted protein complexes runs in the background. Hermes starts the run, checks on it and gives you the json when it's ready.

**Does AlphaFold include complexes of identical and different proteins?**

Yes. AlphaFold DB includes homodimers, which contain two identical proteins, and heterodimers, which contain two different proteins.

**How recently has AlphaFold expanded its complex coverage?**

EMBL-EBI announced a viral complex expansion on September 24, 2026, providing predictions for over 2,800 viruses. That is a documented dataset addition, not a promise of daily updates.

**Are the complex predictions on the AlphaFold website already filtered?**

Yes. Displayed complex entries pass thresholds of pDockQ2max ≥ 0.23 and ipSAEmax ≥ 0.6, so their score distribution excludes predictions below those cutoffs.

**What does an ipTM score tell me?**

ipTM measures confidence in how the protein chains fit together. EMBL-EBI describes scores above 0.8 as confident predictions and scores below 0.6 as suggesting a failed prediction.

**Why distinguish pLDDT from interface confidence?**

pLDDT measures local confidence residue by residue. For a complex, ipTM addresses a different question: confidence in the relative positions of its chains.

