[Integrations](https://spiral.ai/integrations) › [Windsurf](https://spiral.ai/integrations/windsurf) › [ChEMBL target details](https://spiral.ai/integrations/windsurf/chembl-target-details)

# How to Use ChEMBL target details in Windsurf

Returns one ChEMBL target’s name, organism, target type, and component identifiers. Use it to check exactly which biological target an existing ChEMBL ID represents before annotating a dataset.

|  |  |
| --- | --- |
| Model | ChEMBL target details |
| 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 ChEMBL target details in Windsurf

- Use ChEMBL target details for CHEMBL203 and create a JSON fixture containing its preferred name, organism, target type, and component identifiers.
- Use ChEMBL target details for CHEMBL1955 and compare its organism and component identifiers with the target annotations already in this project.
- Use ChEMBL target details to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from ChEMBL target details and tell me what changed since last week.
- Check ChEMBL target details and summarize what you find in three bullet points.

## How to set up ChEMBL target details in Windsurf

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

### Use Spiral's MCP server

1. **Add the server**: Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: `~/.config/devin/mcp_config.json` on macOS and Linux, `%APPDATA%\devin\mcp_config.json` on Windows. Add this:

```json
{
  "mcpServers": {
    "spiral": {
      "url": "https://api.spiral.ai/mcp"
    }
  }
}
```

2. **Sign in**: Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

```bash
devin mcp login spiral
```

3. **Check it**: Spiral is listed under This computer in Customize › MCPs. From the terminal:

```bash
devin mcp list
```

### Use the Spiral skill

1. **Send Windsurf 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 ChEMBL target details**: 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": "ebi-ac-uk/targets/get_target",
    "input": {
      "chembl_id": "<chembl_id>"
    }
  }'
```

Then paste one of the prompts above: Windsurf finds ChEMBL target details on Spiral, shows the price and runs it.

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

## ChEMBL target details tools and prices

- [ChEMBL · Get target](https://spiral.ai/tools/alexandria/ebi-ac-uk/targets/get_target) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| url |  | — | ChEMBL target page, e.g. https://www.ebi.ac.uk/chembl/explore/target/CHEMBL203. |
| chembl_id |  | — | Target ChEMBL ID, e.g. CHEMBL203 (EGFR). Pattern: ^CHEMBL[0-9]{1,12}$. |
| include_xrefs |  | — | Add component cross-references (hundreds for well-studied proteins). |

## What can you do with ChEMBL target details in Windsurf?

Add ChEMBL target identities to a research dataset in your project. A coding agent can reconcile names and IDs, then expose species and protein-component differences before downstream analysis.

### Annotate a research target list

Resolve gene names or existing ChEMBL IDs into a table of preferred target names, organisms, target types, and protein component identifiers.

### Check species before comparing experiments

Inspect the recorded organisms for candidate targets before placing human, mouse, and rat records in the same research comparison.

### Separate proteins from complexes

Review target types and component accessions to distinguish an individual protein from a complex containing that protein before selecting records for analysis.

### Prepare a target identity brief

Create a concise reference sheet with ChEMBL identifiers, preferred names, species, and component identifiers for a medicinal chemistry project.

### Review target metadata after a release

Compare newly retrieved target records with a saved research snapshot and flag changes in names, organisms, target types, or components for review.

### Prepare identifiers for bioactivity research

Establish the intended ChEMBL target ID and biological scope before using a separate bioactivity resource to investigate compounds tested against it.

## Overview

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

## ChEMBL target details in other agents

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

## More Windsurf guides

- [ChEMBL molecule search](https://spiral.ai/integrations/windsurf/chembl-molecule-search)
- [ChEMBL target search](https://spiral.ai/integrations/windsurf/chembl-target-search)
- [ChEMBL molecule details](https://spiral.ai/integrations/windsurf/chembl-molecule-details)
- [ClinVar genetic change details](https://spiral.ai/integrations/windsurf/clinvar-genetic-change-details)
- [ChEMBL drug indications](https://spiral.ai/integrations/windsurf/chembl-drug-indications)
- [ClinVar genetic change search](https://spiral.ai/integrations/windsurf/clinvar-genetic-change-search)

## Questions about ChEMBL target details in Windsurf

**Can Windsurf use ChEMBL target details?**

Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run ChEMBL target details like any built-in tool.

**How much does ChEMBL target details cost in Windsurf?**

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

**Do I need an Alexandria account to use ChEMBL target details in Windsurf?**

No. Spiral runs ChEMBL target details on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up ChEMBL target details in Windsurf?**

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

**Does Windsurf wait while ChEMBL target details runs?**

ChEMBL target details runs in the background. Windsurf starts the run, checks on it and gives you the json when it's ready.

**How often does ChEMBL update its data?**

ChEMBL documents approximately two to three releases per year. These endpoints read release-based data, so they are suited to research updates rather than tracking newly published findings as they appear.

**Does ChEMBL cover only protein targets?**

No. Its target dictionary also includes organisms, tissues, and cell lines, so a target record does not necessarily represent an individual protein.

**Does one UniProt accession identify just one ChEMBL target?**

No. ChEMBL’s documented Q13936 example retrieves individual-protein and multi-protein target records containing the same accession. Check the target type and components before choosing an ID.

**Does a target ID distinguish a mutated protein from its parent?**

No. ChEMBL assigns the same target ID to the parent and mutated proteins; the distinction is recorded with the assays. Target metadata alone cannot establish which mutation an experiment tested.

**Can I retrieve target records from an earlier ChEMBL release?**

The ChEMBL API serves the current release and cannot retrieve previous versions. Earlier database dumps remain available for version-specific research.

