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

# Connect AI clients to Bily

> Give compatible AI clients governed access to scoped Bily data, analytics, and supported actions.

Bily MCP lets compatible AI clients discover and run supported Bily operations within your access boundaries. The public Streamable HTTP endpoint exposes two tools:

* `search` finds the right operation in the current Bily catalog.
* `execute` runs an async function with the selected `bily.*` helper.

The catalog currently contains 64 operations. They cover identity, stores, metrics, analytics, breakdowns, connected-platform reads, and supported writes.

Use `search` as the source of truth. The catalog can grow without adding another top-level MCP tool.

```mermaid theme={null}
flowchart LR
  A["Your AI client"] --> B["Bily MCP"]
  B --> C["search"]
  B --> D["execute"]
  C --> E["Bily operation catalog"]
  D --> F["Scoped Bily result"]
```

## Move from intent to a scoped result

1. Your client connects to `https://api-dispatcher.bily.ai/mcp`.
2. Bily authenticates the connection and applies organization and store access.
3. The client calls `search` with the user's intent.
4. `search` returns matching helpers, inputs, risk guidance, and verification steps.
5. The client calls `execute` with a focused async arrow function.
6. Bily returns the JSON-serializable result and captured logs.

Start a new connection with `bily.context()`. One read returns the authenticated user, accessible organizations, and each organization's nested stores.

<Info>
  Bily MCP exposes tools only. It does not publish MCP resources or prompts. Use the documentation resources below for agent-readable guidance.
</Info>

## Choose your next step

<CardGroup cols={2}>
  <Card title="Quickstart" icon="bolt" href="/mcp/quickstart">
    Connect a client through Bily Connect and verify both tools.
  </Card>

  <Card title="Client configuration" icon="sliders" href="/mcp/client-configuration">
    Configure the endpoint, transport, sign-in flow, or fallback key.
  </Card>

  <Card title="Tools and operations" icon="wrench" href="/mcp/tools">
    Review the exact `search` and `execute` contracts.
  </Card>

  <Card title="Safety and permissions" icon="shield-check" href="/mcp/safety">
    Apply scope, approval, verification, and credential safeguards.
  </Card>
</CardGroup>

## Give agents product context

* [Documentation index](https://docs.bily.ai/llms.txt) provides a compact map of the public docs.
* [Complete documentation](https://docs.bily.ai/llms-full.txt) provides the authored public content in one file.

These files help agents find public documentation. They are not authentication URLs or MCP endpoints.

<Card title="Choose the API or MCP" icon="arrows-split-up-and-left" href="/guides/api-mcp-selection">
  Compare interactive AI-client work with deterministic server integrations.
</Card>