[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Companies House PSC snapshot status](https://spiral.ai/integrations/opencode/companies-house-psc-snapshot-status)

# How to Use Companies House PSC snapshot status in opencode

Returns publication information for the current daily PSC snapshot and its downloadable parts. Use it to identify the publication for a bulk ownership refresh before processing its records.

|  |  |
| --- | --- |
| Model | Companies House PSC snapshot status |
| 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 PSC snapshot status in opencode

- Use Companies House PSC snapshot status to identify the current publication, then write its publication details into our ownership import manifest.
- Use Companies House PSC snapshot status to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Companies House PSC snapshot status and tell me what changed since last week.
- Check Companies House PSC snapshot status and summarize what you find in three bullet points.
- Pull the newest data from Companies House PSC snapshot status and give me the result as a table.

## How to set up Companies House PSC snapshot status 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 PSC snapshot status**: 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/psc_status",
    "input": {}
  }'
```

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

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

## Companies House PSC snapshot status tools and prices

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

## What can you do with Companies House PSC snapshot status 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.

### Build a company ownership reference database

Identify the current PSC publication, process its parts, and include the final part in the import. Use company searches and individual company control records to investigate selected results.

### Review incomplete ownership disclosures

Use a dated PSC publication to assemble a company review queue, including records in its final part. Check selected companies' public control records for statements or exemption information.

### Reconcile a daily ownership import

Check which PSC publication is current and reconcile the imported final part with the snapshot summary. Investigate company-level differences through public ownership and control records.

### 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 PSC snapshot status in other agents

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

## More opencode guides

- [Colorado business search](https://spiral.ai/integrations/opencode/colorado-business-search)
- [Companies House advanced company search](https://spiral.ai/integrations/opencode/companies-house-advanced-company-search)
- [Colorado business filing history](https://spiral.ai/integrations/opencode/colorado-business-filing-history)
- [Companies House alphabetical company search](https://spiral.ai/integrations/opencode/companies-house-alphabetical-company-search)
- [Colorado business entity details](https://spiral.ai/integrations/opencode/colorado-business-entity-details)
- [Companies House charge details](https://spiral.ai/integrations/opencode/companies-house-charge-details)

## Questions about Companies House PSC snapshot status in opencode

**Can opencode use Companies House PSC snapshot status?**

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

**How much does Companies House PSC snapshot status 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 PSC snapshot status in opencode?**

No. Spiral runs Companies House PSC snapshot status 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 PSC snapshot status in opencode?**

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

**Does opencode wait while Companies House PSC snapshot status runs?**

Companies House PSC snapshot status 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.

