Spiral gives your agent every tool with one account. Browse the tools →

opencode · Lead Gen

How to Use Companies House register search in opencode

Returns public register search matches for companies, officers, or disqualified officers. Use company matches to find the registered entity and company number before reviewing its officers or ownership disclosures.

Prompts to try with Companies House register search in opencode

Copy an example into opencode, or ask in your own words.

Use Companies House register search to find Tesco PLC, then add its registered company number and returned company details to our business review fixture.

Companies House register searchopencode
Try asking
  • Use Companies House register search to look this up and give me the result as a table. Save the result in ./assets.

  • Pull the latest numbers from Companies House register search and tell me what changed since last week.

  • Check Companies House register search and summarize what you find in three bullet points.

  • Pull the newest data from Companies House register search and give me the result as a table.

How to set up Companies House register search 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.

    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.

    opencode mcp auth spiral
  3. Check it

    Spiral shows as connected.

    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.

    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 register search

    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/search",
        "input": {
          "query": "<query>"
        }
      }'

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

Companies House register search providers and prices

Spiral runs Companies House register search through Alexandria. Open a card for today's price, with every fee included.

AlexandriaLead Gen
Companies House · Search
find-and-update-company-information-service-gov-uk/companies/search

Settings you can ask for

Ask opencode for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Kindcompanies, officers, disqualified, or allcompanies

kind

Page1 to 10001

One page per call. 1000 is a tool request bound, not a guarantee of source coverage.

Every API field of Companies House · Search is on its tool page: open its card above.

What can you do with Companies House register search 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.

Review a proposed subsidiary

Screen the proposed company name, identify businesses with similar names, and review their registered officers and control disclosures before choosing a name.

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.

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.

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.

Questions about Companies House register search in opencode

Can opencode use Companies House register search?

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

How much does Companies House register search 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 register search in opencode?

No. Spiral runs Companies House register search 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 register search in opencode?

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

Does opencode wait while Companies House register search runs?

Companies House register search 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.

Get started

Start using Companies House register search in opencode

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into opencode:

Set up opencode

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options