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

> ## Agent Instructions
> Forager is a REST API for B2B people, company and job post data: contact lookups (phone numbers, personal emails, work emails), person, company and job post search, and bulk data feeds.
> Server: https://api-v2.forager.ai. Send the API key in the X-API-KEY header. Most paths include {account_id}. Read FORAGER_API_KEY and FORAGER_ACCOUNT_ID from the environment; never put the key in client-side code, logs or prompts.
> To add Forager to a project, follow https://www.forager.ai/docs/guides/agent-quickstart.md. To pick an endpoint, read https://www.forager.ai/docs/guides/choose-an-endpoint.md. For end-to-end builds, see https://www.forager.ai/docs/recipes/overview.md.
> Most requests spend credits. Do not guess costs; use https://www.forager.ai/docs/api-overview/credit-pricing.md and ask the user before spending credits.
> Use only endpoints and fields defined in https://www.forager.ai/docs/openapi.yaml. Forager has no MCP server for the API yet; the /mcp endpoint on this site searches the documentation only.

# Build with AI agents

> Use Forager from AI agents today: the REST API with your API key and the OpenAPI spec, llms.txt, the docs MCP server and the Forager API skill.

![AI agents read the Forager docs through llms.txt, Markdown pages, the skill file and the OpenAPI spec](https://mintcdn.com/forager/EGsWCxLOYv1Cb__c/images/illustrations/ai-agents-docs-llms-txt-markdown-skill.svg?fit=max\&auto=format\&n=EGsWCxLOYv1Cb__c\&q=85\&s=acfe4974d40dc75f3e67da9fb3cfa44b)

AI agents can use Forager today through the REST API and this documentation. This page lists what is available now.

## Call the API from an agent

The Forager API is a standard REST API described by an OpenAPI 3 spec.

1. [Create an account](https://www.forager.ai/docs/api-overview/create-an-account.md) and copy your **API key** and your **Account ID**.
2. Send the key in the `X-API-KEY` header on every request. See [Authentication](https://www.forager.ai/docs/api-overview/authentication.md).
3. Give your agent the OpenAPI spec so it can discover operations and parameters: [openapi.yaml](https://www.forager.ai/docs/openapi.yaml). The API server is `https://api-v2.forager.ai`.
4. Point your agent at a worked example: each of the [recipes](https://www.forager.ai/docs/recipes/overview.md) solves one job end to end and starts with a prompt you can paste into a coding agent.

> [!WARNING]
>
> Most requests consume credits. See [Credit pricing](https://www.forager.ai/docs/api-overview/credit-pricing.md) before letting an agent run unattended, and keep your API key out of prompts, logs and source control.

## Read these docs from an agent

They are served from the same host as this documentation, `https://www.forager.ai/docs`.

| What | Path (relative to the docs URL) | Use it for |
| - | - | - |
| `llms.txt` | `/llms.txt` | A short index of all pages, for an agent to decide what to read. |
| `llms-full.txt` | `/llms-full.txt` | The full documentation as one text file. |
| Markdown of a page | Add `.md` to a page URL | A single page without the site chrome. |
| Docs MCP server | `/mcp` | Search and read these docs from an MCP client. |

Every page also has a menu with **Copy page**, **View as Markdown**, **Open in ChatGPT**, **Open in Claude** and MCP actions.

### Connect the docs MCP server

The docs MCP server lets an MCP-capable client (for example Claude, Cursor or VS Code) search these docs. It does not call the Forager API and does not need your API key.

1. Take the docs URL, `https://www.forager.ai/docs`, and append `/mcp`.
2. Add that URL as a remote MCP server in your client's settings.
3. Or use **Connect MCP** or **Copy MCP server URL** from the menu at the top of any page.

## Use the Forager API skill

A ready-made agent skill describes when to use the Forager API, how to authenticate, the core tasks and their endpoints, and rules for spending credits. It follows the [Agent Skills](https://agentskills.io) format and is published at [/skill.md](https://www.forager.ai/docs/skill.md), where agents look for it, and in the `/.well-known/agent-skills/` index. Add it to a skill-aware agent (for example Claude Code) by saving it as `forager-api/SKILL.md` in the agent's skills directory.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.