> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crustdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex plugin

> Connect Crustdata to OpenAI Codex with two commands: MCP data tools covering 800M+ people profiles and 200M+ companies, bundled skills, and one sign-in.

The Crustdata plugin for Codex bundles the [MCP server](/for-agents/mcp) and ready-to-run skills into a single install. Two commands add the data tools (800M+ people profiles and 200M+ companies) and the skills.

<Note>
  This installs Crustdata in **Codex**, the coding agent. To use Crustdata in **ChatGPT** itself, add the [ChatGPT connector](/integrations/chatgpt) instead.
</Note>

* **Two commands to install.** The data tools and the skills come together, no config file to hand-write.
* **Sign in once.** A browser sign-in, no API key to paste.
* **The same endpoint everywhere.** The plugin registers `https://install.crustdata.com/mcp`.

## Before you start

* Codex installed and signed in. Run `codex login` if `codex login status` reports **Not logged in**.
* A Crustdata account. [Sign in or create one](https://app.crustdata.com/auth/login).

## Quick start

<Steps>
  <Step title="Install the plugin">
    Add the Crustdata marketplace and install the plugin:

    ```bash theme={"theme":"vitesse-black"}
    codex plugin marketplace add crustdata/skills
    codex plugin add crustdata@crustdata-plugin
    ```
  </Step>

  <Step title="Sign in">
    ```bash theme={"theme":"vitesse-black"}
    codex mcp login crustdata
    ```

    Your browser opens for a one-time sign-in. No key to paste.
  </Step>

  <Step title="Start using it">
    Ask Codex a question, or run one of the bundled skills.
  </Step>
</Steps>

## Check it worked

```bash theme={"theme":"vitesse-black"}
codex mcp list
```

Crustdata should appear with a status of `enabled`:

```
Name       Url                                Bearer Token Env Var  Status   Auth
crustdata  https://install.crustdata.com/mcp  -                     enabled  OAuth
```

## Example prompts

| Prompt                                                                | What it does                             |
| --------------------------------------------------------------------- | ---------------------------------------- |
| "Find AI startups hiring engineers, then get me the founders' emails" | Search, then enrich, in a single step    |
| "Who are the engineering leaders at Anthropic?"                       | Searches people by seniority and company |
| "What jobs does Stripe have open right now?"                          | Fetches live job listings                |
| "Enrich this company with headcount and funding"                      | Pulls a full firmographic profile        |
| "How many credits do I have?"                                         | Checks your account balance              |

## Skills

Ask Codex what it installed:

> What Crustdata skills do you have?

Eight ship with the plugin, namespaced `crustdata:`:

| Skill                           | What it does                                                                                                              |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| `crustdata:account-research`    | Account deep-dive and plan, org chart, tech stack and wedge, or a competitive battlecard                                  |
| `crustdata:candidate-sourcing`  | Find engineering candidates, verify profiles, find business and personal emails, draft outreach into Gmail                |
| `crustdata:email-enrichment`    | Turn a list of email addresses into person profiles, with verification and resume on long lists                           |
| `crustdata:icp-builder`         | One-time setup: turn one profile URL into your ICP, persona and writing voice for the other skills to read                |
| `crustdata:meeting-prep`        | Score inbound against your ICP, build a one-screen pre-call brief, or plan discovery and a demo flow                      |
| `crustdata:sales-outreach`      | Cold emails, call scripts, social notes, replies, objection talk-tracks and sequences, each grounded in one recent signal |
| `crustdata:sales-prospecting`   | Net-new lists, lookalikes, account ranking, event lists, expansion radar, TAM sizing and champion tracking                |
| `crustdata:warm-path-workspace` | An interactive deal workspace: buying-group map, stakeholder dossiers, live signals and ranked warm-intro paths           |

## What's included

<CardGroup cols={2}>
  <Card title="MCP data tools" icon="magnifying-glass">
    The full Crustdata [MCP server](/for-agents/mcp): search and enrich companies, people, and jobs, and read social and web content, in plain English.
  </Card>

  <Card title="Skills" icon="wand-magic-sparkles">
    Ready-made workflows for prospecting, account research, outreach, meeting prep, and candidate sourcing.
  </Card>

  <Card title="One sign-in" icon="key">
    The data tools and the skills share a single sign-in. No API key to copy or paste.
  </Card>
</CardGroup>

<Callout icon="coins" color="#5345e4">
  Credit costs vary by request and plan. See [Pricing](/general/pricing) for
  per-request credit costs and [Rate limits](/general/rate-limits) for limits.
</Callout>

## Troubleshooting

* **`MCP tool call requires approval`.** Non-interactive runs (`codex exec`) decline tool calls that need approval. Run Codex interactively and approve the call.
* **`Not inside a trusted directory`.** `codex exec` expects a git repository. Run it in your project, or pass `--skip-git-repo-check`.
* **The sign-in does not stick.** Run `codex mcp login crustdata` again. Judge it by whether a request works, not by the `Auth` column.

## Support

For help or feedback, contact [support@crustdata.co](mailto:support@crustdata.co).


## Related topics

- [Connect Crustdata to your stack](/integrations/overview.md)
- [Claude Code plugin](/integrations/claude-plugin.md)
- [ChatGPT connector](/integrations/chatgpt.md)
- [MCP Server](/for-agents/mcp.md)
- [Crustdata CLI](/for-agents/cli.md)