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.
Prompts to try with Companies House officer appointments in opencode
Copy an example into opencode, or ask in your own words.
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
- 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.
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
- 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.
opencode mcp auth spiral
- Check it
Spiral shows as connected.
opencode mcp list
Use the Spiral skill
- Send opencode this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Companies House officer appointments
One request; the result comes back by polling or a webhook.
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.
Companies House officer appointments providers and prices
Spiral runs Companies House officer appointments through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask opencode for any of these in your prompt.
| 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 | on or off | current_only |
Every API field of Companies House · Officer appointments is on its tool page: open its card above.
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.
More on Companies House officer appointments and opencode
Overview
Companies House officer appointments in other agents
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.
Start using Companies House officer appointments in opencode
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into opencode:
set up https://spiral.ai/SKILL.md


