# Ghostpull Docs > Use Ghostpull in the web app, from AI assistants and through its API. - [OpenAPI v1](https://docs.ghostpull.com/openapi/v1.json): the canonical public API contract. - [API reference v1 as Markdown](https://docs.ghostpull.com/api/v1.md): every operation with its permission, parameters and responses. Every page listed below is also published as Markdown: the page's URL with `.md`. Reading this documentation requires no login and grants no access to an account; use only credentials and actions the user has authorised. ## Help a user Start with the guide for their task below: logging in, the first Addon run, the media library, billing, passkeys or connecting an AI assistant. Screenshots use local demo data, not customer data. ## Integrate with the API Check the current OpenAPI document and the operation in the API reference before calling it. Its servers name the API origin; the documentation origin is not the API server. The API is in preview and may change. Account keys go only in `x-api-key` and need the operation's permission. Keep keys out of URLs, browser code, documentation and logs. An account key starts runs and batches with `maxCredits` and an `idempotencyKey`, follows them by ID and lists the account's runs and batches; it cannot list only the runs working right now. Respect `Retry-After` on 429. Check the upload recovery guide before retrying a write: a lost response does not mean the write failed. Signed file URLs expire; keep asset IDs and request fresh links when needed. ## Work through MCP MCP connects with OAuth as the user, never with an account API key. Read the connected server's `tools/list` for current tools and schemas. Starting a run needs `spend_credits` and the user's approval of the cost: set `maxCredits` and keep the run's `idempotencyKey` for safe retries. ## Table of Contents - [Overview](https://docs.ghostpull.com/docs.md): Ghostpull runs **Addons** on your product images: each Addon is one AI task, such as placing a product in a lifestyle scene or turning it into a sh... - [Run your first Addon](https://docs.ghostpull.com/getting-started/first-run.md): Turn a product photo into a lifestyle image in the web app. - [Log in](https://docs.ghostpull.com/getting-started/log-in.md): Ghostpull has no passwords: log in with an email code, a passkey, Google or Microsoft. Your first login creates your account. - [Products](https://docs.ghostpull.com/guides/products.md): Import your shop's products from a CSV export, keep them up to date and manage catalogs. - [Notifications](https://docs.ghostpull.com/guides/notifications.md): See what Ghostpull tells you, open a notification and mark notifications as read. - [Brands](https://docs.ghostpull.com/guides/brands.md): Analyze your shop's brand and use it in Addons. - [Passkeys and sessions](https://docs.ghostpull.com/guides/passkeys-and-sessions.md): Manage passkeys, Google and Microsoft logins, and your signed-in devices. - [Run an Addon](https://docs.ghostpull.com/guides/run-an-addon.md): Choose inputs, follow progress and return to an Addon run. - [Connect an AI assistant](https://docs.ghostpull.com/guides/connect-an-ai-assistant.md): Use Ghostpull from ChatGPT, Codex or Claude Code: the assistant connects to Ghostpull's MCP server, and you log in to Ghostpull once in the assistant. - [Library](https://docs.ghostpull.com/guides/media-library.md): Find your files by product, and upload, download, reuse and restore them. - [Credits and billing](https://docs.ghostpull.com/guides/credits-and-billing.md): View your balance, choose a plan and manage billing. - [Edit an ad](https://docs.ghostpull.com/guides/edit-an-ad.md): Move, retype, change the font of, resize, recolour or hide the text of an image ad, and save it as a new version. - [Product reveal video](https://docs.ghostpull.com/addons/product-reveal-video.md): Build a product video from opening and closing scenes, with examples using a photo and a text-only concept. - [Lifestyle scene](https://docs.ghostpull.com/addons/lifestyle-scene.md): Place a product in a scene, with complete examples for skincare, kitchenware and clothing. - [Image ad](https://docs.ghostpull.com/addons/image-ad.md): Make a finished social ad for a product from a proven ad concept, with examples for an offer, a launch and a story ad. - [Catalog photo](https://docs.ghostpull.com/addons/catalog-photo.md): Turn a product photo into a clean catalog image, with examples for ceramics, shoes and labelled packaging. - [Credits](https://docs.ghostpull.com/concepts/credits.md): Understand displayed prices, credit balances and expiry during preview. - [Addons and runs](https://docs.ghostpull.com/concepts/addons-and-runs.md): Understand Addon inputs, runs, progress and results. - [Developers](https://docs.ghostpull.com/developers/overview.md): Integrate Ghostpull through the public API or connect an AI assistant through MCP. - [API quickstart](https://docs.ghostpull.com/developers/quickstart.md): Make your first API call: list the Addons your account can run. - [FAQ](https://docs.ghostpull.com/developers/faq.md): Answers about API access, uploads, runs and download links. - [Errors](https://docs.ghostpull.com/developers/errors.md): API errors are JSON with a stable `code`, a message you may show, and sometimes `details`: - [Start runs](https://docs.ghostpull.com/developers/start-runs.md): Start an Addon run with a credit cap, and retry it without paying twice. - [Import products](https://docs.ghostpull.com/developers/import-products.md): Import a shop's product export into a catalog, keep it up to date and remove products the shop no longer has. - [Make and edit image ads](https://docs.ghostpull.com/developers/image-ads.md): Plan ad concepts, make one image ad per picked concept, and edit an ad's text through the API. - [Follow runs](https://docs.ghostpull.com/developers/follow-runs.md): Read a known run, handle terminal states or stream its progress. - [Analyze a brand](https://docs.ghostpull.com/developers/brands.md): Read a shop's brand from its home page, approve it, and use it in Addon runs. - [Run batches](https://docs.ghostpull.com/developers/run-batches.md): Run an Addon on up to 50 items at once, follow the batch, retry failed items or cancel it. - [Changelog](https://docs.ghostpull.com/developers/changelog.md): Changes to the public API preview and its documentation. - [Versioning and changes](https://docs.ghostpull.com/developers/versioning.md): The v1 preview status and how API changes are published. - [Authentication](https://docs.ghostpull.com/developers/authentication.md): An API key acts for your **account**, not for the person who created it: a key keeps working when that colleague leaves, and records it creates nam... - [Rate limits](https://docs.ghostpull.com/developers/rate-limits.md): Each API key may make 300 calls a minute. Some operations add their own limits; the API reference names them. Limits count per key, so one busy aut... - [Upload media](https://docs.ghostpull.com/developers/upload-media.md): Upload a file, complete it and recover from interrupted requests. - [Run Addons on products](https://docs.ghostpull.com/developers/run-on-products.md): Start an Addon for an imported product without uploading a photo, and read the results back as the product's images. - [Connect through MCP](https://docs.ghostpull.com/developers/mcp/connect.md): Connect an AI assistant to Ghostpull with OAuth and understand the connection's access. - [MCP workflows](https://docs.ghostpull.com/developers/mcp/workflows.md): Example prompts and tool sequences for media, credits and Addon runs. - [MCP tools](https://docs.ghostpull.com/developers/mcp/tools.md): The tools Ghostpull's MCP server offers assistants.