[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [Y Combinator company search](https://spiral.ai/integrations/claude-code/y-combinator-company-search)

# How to Use Y Combinator company search in Claude Code

Returns matching businesses from YC's public startup directory, including company names, descriptions, and profile links. Use it to build a research shortlist before reading individual profiles or job listings.

|  |  |
| --- | --- |
| Model | Y Combinator company search |
| 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 Y Combinator company search in Claude Code

- Use Y Combinator batch counts and Y Combinator company search to build a Summer 2022 cohort view in this project, showing the published cohort count, company names, descriptions, and profile links.
- Use Y Combinator company search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Y Combinator company search and tell me what changed since last week.
- Check Y Combinator company search and summarize what you find in three bullet points.
- Pull the newest data from Y Combinator company search and give me the result as a table.

## How to set up Y Combinator company search 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 Y Combinator company search**: 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": "ycombinator-com/companies/search",
    "input": {
      "tag": "<tag>"
    }
  }'
```

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

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

## Y Combinator company search tools and prices

- [Y Combinator · Search](https://spiral.ai/tools/alexandria/ycombinator-com/companies/search) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| tag |  | — | Exact tag label, e.g. Developer Tools, AI, Open Source. |
| url |  | — | A pasted https://www.ycombinator.com/companies URL (its query, batch, industry, regions, tags, status, isHiring, top_company and nonprofit parameters; short batch codes like W25 are expanded) or /companies/industry/<slug> (matched to the directory's industry label, else its tag label). Explicit inputs take precedence over URL values. |
| page | 0 to 49 | 0 | Zero-based page; next_page in the output gives the following page or null when exhausted. |
| batch |  | — | Exact batch label as published by YC, e.g. Summer 2025 or Winter 2022. Use the batches function to list valid labels. |
| query |  |  | Free-text search over company names and descriptions. Omit or leave empty to browse by filters only. |
| hiring |  | — | Only companies the directory flags as hiring (true) or not hiring (false). |

## What can you do with Y Combinator company search in Claude Code?

Build a YC research view that connects company descriptions, launch announcements, and advertised jobs. Use published batch counts to organize cohort comparisons and company profiles to explain individual businesses.

### Compare YC cohorts

Compare Summer 2022 and Winter 2022 using published batch counts and company lists. Add profile descriptions, launch announcements, cross-company job results, and individual company openings to explain differences in products and advertised hiring.

### Prepare a startup employer shortlist

Find YC employers advertising engineering roles in San Francisco. Read their profiles, inspect each employer's openings, and review product launches; use company search and batch counts to put the shortlist in its cohort context.

### Research the developer tools market

Build a YC developer tools company list and compare product descriptions with launch announcements. Add advertised engineering roles and company job lists to identify hiring themes, then compare representation across published batches.

### Build a university employer research brief

Search YC internship postings and investigate the companies advertising them. Combine company profiles, individual openings, and launch posts to explain what those employers build; use directory searches and batch counts to show which cohorts the employers represent.

### Find potential software suppliers

Search YC companies building customer support software, read their company descriptions, and review relevant launch posts. Produce a shortlist based on the capabilities each business describes publicly.

## Overview

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

## Y Combinator company search in other agents

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

## More Claude Code guides

- [Y Combinator company profile](https://spiral.ai/integrations/claude-code/y-combinator-company-profile)
- [Y Combinator job search](https://spiral.ai/integrations/claude-code/y-combinator-job-search)
- [Y Combinator company jobs](https://spiral.ai/integrations/claude-code/y-combinator-company-jobs)
- [Y Combinator launch posts](https://spiral.ai/integrations/claude-code/y-combinator-launch-posts)
- [Y Combinator batch counts](https://spiral.ai/integrations/claude-code/y-combinator-batch-counts)
- [ZipRecruiter company jobs](https://spiral.ai/integrations/claude-code/ziprecruiter-company-jobs)

## Questions about Y Combinator company search in Claude Code

**Can Claude Code use Y Combinator company search?**

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

**How much does Y Combinator company search cost in Claude Code?**

$0.00873 per call. 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 Y Combinator company search in Claude Code?**

No. Spiral runs Y Combinator company 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 Y Combinator company search in Claude Code?**

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

**Does Claude Code wait while Y Combinator company search runs?**

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

**Does YC's directory cover every startup?**

Its stated coverage is publicly launched YC companies. That boundary excludes startups outside YC and does not establish coverage of companies that have not launched publicly.

**Is the data limited to US companies?**

YC's directory includes companies outside the United States. For example, it lists Groww in Bengaluru, India, with its Winter 2018 batch.

**Do YC announcements appear only when a batch launches?**

YC says founders can publish launches on any day, at any time. Launch YC includes both recently backed startups and product updates from alumni.

**Can one broad directory search establish complete coverage?**

ReefAPI's source documentation reports a 1,000-hit ceiling for a YC directory query. Divide broad research into narrower searches before treating a company list as complete.

**What business details does YC make public?**

Public company profiles display batch, team size, status, and location, as Firecrawl's profile demonstrates. Public job advertisements can also include role, location, salary text, and requirements.

