[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Companies House officer appointments](https://spiral.ai/integrations/opencode/companies-house-officer-appointments)

# How to Use Companies House officer appointments in opencode

Returns public company appointments associated with one officer identifier, including company names, numbers, roles, and appointment dates. Use it to review corporate connections after identifying an officer in a company record.

|  |  |
| --- | --- |
| Model | Companies House officer appointments |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Companies House officer appointments in opencode

- Use Companies House officer appointments for an officer identifier linked from Tesco PLC's board record, then add the returned company appointments to our corporate governance review.
- Use Companies House officer appointments to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Companies House officer appointments and tell me what changed since last week.
- Check Companies House officer appointments and summarize what you find in three bullet points.
- Pull the newest data from Companies House officer appointments and give me the result as a table.

## How to set up Companies House officer appointments in opencode

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

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

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

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode 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 Companies House officer appointments**: 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": "find-and-update-company-information-service-gov-uk/companies/officer_appointments",
    "input": {
      "officer_id": "<officer_id>"
    }
  }'
```

Then paste one of the prompts above: opencode finds Companies House officer appointments on Spiral, shows the price and runs it.

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

## Companies House officer appointments tools and prices

- [Companies House · Officer appointments](https://spiral.ai/tools/alexandria/find-and-update-company-information-service-gov-uk/companies/officer_appointments) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| page | 1 to 1000 | 1 | One page per call. 1000 is a tool request bound, not a guarantee of source coverage. |
| current_only |  | — | current_only |

## What can you do with Companies House officer appointments in opencode?

Build a UK company review screen that brings registered business records into your project. Use Companies House names, officer appointments, control disclosures, and dated PSC publications to support reviews with identifiable source records.

### Prepare a joint venture briefing

Check the proposed venture name and assemble the partners' registered officer and ownership records. Review associated public appointments where they help explain corporate relationships.

### Plan an acquisition and company rename

Identify the target's registered entity, review its officers and disclosed control, and screen a proposed post-acquisition name. Use public appointment records to support a review of corporate connections.

### Assess a business rebrand

Check a proposed registered name and examine matching companies' public governance records. Give the naming team a factual list of registered businesses requiring closer review.

### Research corporate governance across a portfolio

Combine a dated ownership baseline with selected companies' officer and control records. Review public appointments to explain corporate connections, keeping the analysis focused on businesses.

## Overview

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

## Companies House officer appointments in other agents

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

## More opencode guides

- [Companies House latest PSC snapshot part](https://spiral.ai/integrations/opencode/companies-house-latest-psc-snapshot-part)
- [Companies House officer disqualification record](https://spiral.ai/integrations/opencode/companies-house-officer-disqualification-record)
- [Companies House historic dissolved company search](https://spiral.ai/integrations/opencode/companies-house-historic-dissolved-company-search)
- [Companies House register search](https://spiral.ai/integrations/opencode/companies-house-register-search)
- [Companies House filing history](https://spiral.ai/integrations/opencode/companies-house-filing-history)
- [CompanyEnrich company domain suggestions](https://spiral.ai/integrations/opencode/companyenrich-company-domain-suggestions)

## Questions about Companies House officer appointments in opencode

**Can opencode use Companies House officer appointments?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run Companies House officer appointments like any built-in tool.

**How much does Companies House officer appointments cost in opencode?**

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

**Do I need an Alexandria account to use Companies House officer appointments in opencode?**

No. Spiral runs Companies House officer appointments on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Companies House officer appointments in opencode?**

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

**Does opencode wait while Companies House officer appointments runs?**

Companies House officer appointments runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.

**Does Companies House cover every UK business?**

Companies House is the registry for UK limited companies. Its register should not be treated as a complete directory of every UK business.

**How fresh is Companies House data?**

Companies House describes its API as providing real-time company updates. Its bulk PSC snapshot follows a separate schedule: it updates each morning before 10 a.m. GMT and covers information compiled through the previous day.

**Does registration prove that every company detail is accurate?**

No. Companies House says a close review of every document during registration is not always possible, so a registered record does not establish that every detail is correct.

**Are home addresses and full birth dates public?**

Public PSC information excludes the protected home address and full date of birth. Public register access does not provide unrestricted access to those private details.

**Is a PSC snapshot a complete picture of beneficial ownership?**

The snapshot contains the PSC information supplied to Companies House. It represents disclosed register information, rather than an independent investigation into every company's ownership.

