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

# Quickstart

> Get up and running with your first Bloom agent in under 5 minutes

## Environment Setup

First, you'll need these environment variables:

<AccordionGroup>
  <Accordion title="BLOOM_AGENT_ID">
    Your agent's unique identifier (found in Agents tab)

    ```bash theme={null}
    export BLOOM_AGENT_ID="your-agent-id"
    ```
  </Accordion>

  <Accordion title="BLOOM_ORG_API_KEY">
    Your organization's API key (found in Profile tab)

    ```bash theme={null}
    export BLOOM_ORG_API_KEY="your-org-key"
    ```
  </Accordion>

  <Accordion title="BLOOM_AUTH (MCP Only)">
    Combined auth string for MCP servers

    ```bash theme={null}
    export BLOOM_AUTH="bloom_{ORG_KEY}_agent_{AGENT_ID}"
    ```
  </Accordion>
</AccordionGroup>

## Integration Methods

Choose your preferred integration method:

<CardGroup cols={2}>
  <Card title="Direct API Integration" icon="code" href="/integrations/direct-api">
    Use Bloom's proxy API directly in your Python code
  </Card>

  <Card title="MCP Server Integration" icon="plug" href="/integrations/mcp-server">
    Use the bloom-mcp-wrapper with any stdio MCP server
  </Card>
</CardGroup>

## Test Your Setup

Once configured, test your integration:

```python theme={null}
import requests
import os

def test_bloom_connection():
    response = requests.post(
        "https://iam.bloomtechnologies.app/https://api.openai.com/v1/chat/completions",
        headers={"Authorization": f"Bearer {os.getenv('BLOOM_ORG_API_KEY')}"},
        json={
            "agent_id": os.getenv("BLOOM_AGENT_ID"),
            "messages": [{"role": "user", "content": "Hello, World!"}],
            "model": "gpt-3.5-turbo",
            "max_tokens": 50
        }
    )
    return response.json()

result = test_bloom_connection()
print(result)
```

<Note>
  Make sure your agent has the appropriate OpenAI scopes configured before testing.
</Note>