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

# Examples

> Runnable examples for MCP, REST, and popular agent frameworks

Runnable examples show how to give your agent a simple capability: read Correl8 **guidelines** once per conversation, then post structured **observations** when the rules apply.

**Repository:** [github.com/Correl8AI/examples](https://github.com/Correl8AI/examples)

## Prerequisites

1. A Correl8 workspace and project ([app.correl8.ai](https://app.correl8.ai) — free plan is enough)
2. A project API key — **Settings** → create/copy a key → `CORREL8_API_KEY`
3. `CORREL8_PROJECT_ID` from your project URL: `/project/{project_id}/...`
4. An `OPENAI_API_KEY`

Each example includes its own `.env.example`. Copy it to `.env` before running. The same values work across examples.

## Quick starts (CLI)

| Example                                                                                                      | Integration             | Start here |
| ------------------------------------------------------------------------------------------------------------ | ----------------------- | ---------- |
| [basic-agent](https://github.com/Correl8AI/examples/tree/main/basic-agent)                                   | REST custom tool        | **Yes**    |
| [langchain-agent-observations](https://github.com/Correl8AI/examples/tree/main/langchain-agent-observations) | LangChain + MCP         |            |
| [openai-agents-sdk](https://github.com/Correl8AI/examples/tree/main/openai-agents-sdk)                       | OpenAI Agents SDK + MCP |            |
| [pydantic-ai-agent](https://github.com/Correl8AI/examples/tree/main/pydantic-ai-agent)                       | Pydantic AI + MCP       |            |

## Full demo app

| Example                                                                                      | Description                                                               |
| -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| [movie-recommendation](https://github.com/Correl8AI/examples/tree/main/movie-recommendation) | Browser chat app → agent reads guidelines → `post_observations` → Correl8 |

## Verify

After running an example, check **Observations** in the app:

```
https://app.correl8.ai/project/{CORREL8_PROJECT_ID}/observations
```

See [Quickstart](/quickstart) for the MCP setup path, or [Connect overview](/essentials/connect-overview) for integration options.