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

# MCP overview

> Connect an MCP client to APOB, discover creative tools, and follow asynchronous work.

APOB exposes a remote Model Context Protocol (MCP) endpoint at `/mcp` using
Streamable HTTP. A connected client can discover tools for generation, models,
elements, media transfer, Live scenes, and billing. The server also provides a
resource describing the required `create_image` prompt syntax.

## Connect your client

<Steps>
  <Step title="Obtain the MCP resource URL">
    Use the URL supplied by your integration. The endpoint must be enabled in
    that environment. These examples use `APOB_MCP_URL` for the complete resource
    URL, including `/mcp`; they do not assume a production hostname.
  </Step>

  <Step title="Authorize the connection">
    Add the remote endpoint in an MCP client that supports Streamable HTTP and
    OAuth authorization code with PKCE. Sign in to APOB and review the account
    and client before approving `mcp:access`. See [authentication](/mcp/authentication).
  </Step>

  <Step title="Discover the current tools">
    Initialize the client, then request `tools/list`. Use the returned input
    schemas for your account. Some generation defaults change with the account's
    free or paid status and selected quality.
  </Step>

  <Step title="Submit once and follow the receipt">
    Check inputs, credits, and billing settings before a write. Save returned
    identifiers and follow the existing task. Acceptance is separate from final
    media, payment, or entitlement fulfillment.
  </Step>
</Steps>

<Note>
  MCP uses an OAuth access token. GraphQL uses an APOB API key or Firebase ID
  token. An APOB API key, Firebase ID token, or browser session cookie does not
  replace the MCP bearer token.
</Note>

## Choose a reference

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/mcp/authentication">
    Discover OAuth endpoints, authorize with PKCE, and manage connected apps.
  </Card>

  <Card title="HTTP and JSON-RPC" icon="code" href="/mcp/protocol">
    Initialize, discover capabilities, call tools, and interpret errors.
  </Card>

  <Card title="Tool catalog" icon="list" href="/mcp/tools">
    Find all 34 tools and understand account-specific defaults.
  </Card>

  <Card title="Generation" icon="wand-magic-sparkles" href="/mcp/generation">
    Create, edit, clone, extend, and retrieve final media.
  </Card>

  <Card title="Library and elements" icon="shapes" href="/mcp/library-and-elements">
    Discover assets, train models, and manage reusable references.
  </Card>

  <Card title="Uploads and Live" icon="upload" href="/mcp/uploads-and-live">
    Transfer local files, import remote files, and create or vote on scenes.
  </Card>

  <Card title="Billing" icon="credit-card" href="/mcp/billing">
    Inspect offers and accounts, submit purchases, and follow Checkout status.
  </Card>

  <Card title="Connected apps API" icon="plug" href="/api-reference/mcp-connections">
    Retrieve setup instructions, list connections, and revoke access through GraphQL.
  </Card>
</CardGroup>

## Account and task boundaries

Tool identity comes from the verified connection. Each call rechecks the account;
knowing another account's identifier does not grant access to its private assets.
Generation results are restricted to the owner of the root generation task.

Creation and billing writes can spend credits or charge a saved payment method.
Repeated writes can execute again. If a response is uncertain, reconcile the
existing task, account history, or payment before considering another write.
Read [credits and billing](/credits-and-billing) before running paid work.

The setup instructions returned by the [GraphQL API](/api-reference/mcp-connections)
describe client configuration. Successful use also depends on the enabled
endpoint and the client's transport and OAuth support.


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