[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [Akta company lists](https://spiral.ai/integrations/claude-code/akta-company-lists)

# How to Use Akta company lists in Claude Code

Returns companies matching structured criteria or a plain-language search. Use it to discover businesses in a market before requesting details on the companies worth examining.

|  |  |
| --- | --- |
| Model | Akta company lists |
| Available through | Alexandria |
| Category | News & Media |
| Price | Up to $0.17459 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Akta company lists in Claude Code

- Use Akta company lists to find a matching business software company in Germany and display the returned company record in the terminal.
- Use Akta company lists to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Akta company lists and tell me what changed since last week.
- Check Akta company lists and summarize what you find in three bullet points.
- Pull the newest data from Akta company lists and give me the result as a table.

## How to set up Akta company lists in Claude Code

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

### Use Spiral's MCP server

1. **Add the hosted server**: This adds Spiral to the current project. Add `--scope user` to use it in every project.

```bash
claude mcp add --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `claude`, type `/mcp`, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

### Use the Spiral skill

1. **Send Claude Code 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 Akta company lists**: 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": "akta/companies/list",
    "input": {
      "query": "<query>"
    }
  }'
```

Then paste one of the prompts above: Claude Code finds Akta company lists on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/claude-code

## Akta company lists tools and prices

- [Akta · Company list](https://spiral.ai/tools/alexandria/akta/companies/list) (Alexandria): Up to $0.17459 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| limit | 1 to 2 | — | Companies to return. Omission sends 1. Filters allow 2. A query allows 1. Akta's own maximum is 500, and 20 on pay-as-you-go. |
| query |  | — | Natural-language company search. Cannot be combined with filters. limit is capped at 1. |
| offset | 0 to … | 0 | Companies to skip. |
| filters |  | — | Structured filters from companies/filters. Dotted keys such as firmographic.company_type and location.hq.country. Cannot be combined with query. |
| sort_by | relevance, revenue_estimate, valuation_estimate, employee_range, total_funding, founded_year | — | Sort field. Default relevance. |
| sections |  | — | Company sections to attach. Rejected: any section on one company exceeds the 100 Firecrawl credit cap. Use companies/enrich. |

## What can you do with Akta company lists in Claude Code?

Build an internal company research tool that turns a market brief into candidates and company comparisons. A coding agent can use Akta's filter translation, company matches, identity records, and selected profile sections in the project's research workflow.

### Compare potential software suppliers

Translate a brief for US business software suppliers into search filters, retrieve matching companies, confirm their identities, and inspect product and technology details for an internal comparison.

### Map a market before researching individual companies

Define a market such as UK business software, build matching company criteria, retrieve candidates, resolve their identities, and examine business models and industry classifications.

### Screen companies for acquisition research

Turn a target-company brief into filters, find candidates, confirm which businesses the results identify, and inspect firmographics and modeled financials for preliminary internal screening.

### Find businesses for partnership research

Describe the industry and location of potential business partners, translate those requirements into filters, retrieve matches, resolve company identities, and review their products and business models.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Claude Code guides](https://spiral.ai/integrations/claude-code)

## Akta company lists in other agents

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

## More Claude Code guides

- [Akta company details](https://spiral.ai/integrations/claude-code/akta-company-details)
- [Akta company lookup](https://spiral.ai/integrations/claude-code/akta-company-lookup)
- [60.tools WoW Forever talents](https://spiral.ai/integrations/claude-code/60-tools-wow-forever-talents)
- [Akta company search filters](https://spiral.ai/integrations/claude-code/akta-company-search-filters)
- [60.tools WoW Forever item details](https://spiral.ai/integrations/claude-code/60-tools-wow-forever-item-details)
- [Akta industry code search](https://spiral.ai/integrations/claude-code/akta-industry-code-search)

## Questions about Akta company lists in Claude Code

**Can Claude Code use Akta company lists?**

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Akta company lists like any built-in tool.

**How much does Akta company lists cost in Claude Code?**

Up to $0.17459 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude Code plan is separate.

**Do I need an Alexandria account to use Akta company lists in Claude Code?**

No. Spiral runs Akta company lists on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Akta company lists in Claude Code?**

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

**Does Claude Code wait while Akta company lists runs?**

Akta company lists runs in the background. Claude Code starts the run, checks on it and gives you the json when it's ready.

**Does Akta cover private companies outside the US?**

Yes. Akta documents global coverage of more than 20 million private and public companies, with more than 75 data points in its company data offering.

**Where do Akta company records come from?**

Company enrichment retrieves structured records from Akta's native database. The documented coverage includes both private and public businesses.

**Are Akta revenue and valuation figures reported financial statements?**

Akta describes its financial estimate section as modeled financial performance. It includes revenue, growth rate, valuation, funding, and profitability estimates.

**Does company enrichment return the entire company record?**

It returns only the requested sections. Akta separates company information into sections such as firmographics, business model, financials, products, industry, and technology.

