Check before spending
Read the account balance and live image/video pricing catalog, including which Gemini image models the MCP generation tool currently accepts.
Remote MCP · OAuth · Streamable HTTP
Give your agent an image pipeline.
Connect Pixapi once, then let your agent inspect live pricing, submit Gemini image tasks, and collect the finished result without handling API keys.
Connection address
https://api.pixapi.ai/mcpNo Node.js requiredNo API key copyAsync task results
remote / stateless
01connecthttps://api.pixapi.ai/mcp
02authOAuth + PKCE
03scopepixapi:tools
04transportStreamable HTTP
Three Pixapi tools ready after authorization
Add this URL as a Remote MCP server. The endpoint accepts MCP requests, not normal browser navigation.
What MCP can do
One small toolset, one complete image run.
The public MVP stays focused on the steps an agent needs to price, start, and finish an image-generation job.
Create an image task
Submit an asynchronous text-to-image task with a supported Gemini model, prompt, image count, and optional aspect ratio.
Return with the result
Poll the account-owned task until it completes, then return the generated image URL or the recorded failure.
OAuth authorization
Sign in to Pixapi. Do not paste a secret.
Clients that support Remote MCP and OAuth discover the Pixapi authorization server automatically and use authorization code flow with S256 PKCE.
The client receives delegated access
Authorization is limited to the pixapi:tools scope. Your Pixapi password is entered only on pixapi.ai, and the client uses revocable access and refresh tokens afterward.
- 01
Add the Remote MCP URL
In your client's connector or MCP settings, add https://api.pixapi.ai/mcp.
- 02
Continue in the browser
Pixapi opens its sign-in page. Use the same account that owns your credits and generation history.
- 03
Approve tool access
Review and grant the pixapi:tools permission requested for this client.
- 04
Return to your agent
The client completes the OAuth exchange, lists the tools, and can call them within your account.
Three public tools
Clear verbs. Structured results.
Every tool exposes an input and output schema so an agent can select it deliberately and handle the result without guessing.
tool.01
pixapi_get_pricing_and_balance
Returns your current credit balance and the live image/video model pricing catalog.
Only entries marked mcp_generate_supported=true can be sent to the MCP image generation tool.
tool.02
pixapi_generate_image
Creates one asynchronous Gemini text-to-image task and immediately returns a task_id.
The current MCP tool does not generate with GPT Image models, edit images, or create videos.
tool.03
pixapi_get_task
Reads the latest status, progress, cost, result URL, or error for a task owned by your account.
Poll this tool for an existing task instead of submitting the generation request again.
Client support
Compatibility starts with open standards.
The default path is standards-based Remote MCP plus OAuth. Product plans, workspace policies, and client releases can affect whether a custom remote connector is available.
Supported path
Remote MCP + OAuth clients
Use the connection URL directly when the client supports Streamable HTTP, protected-resource discovery, dynamic client registration, and PKCE.
Check your client
ChatGPT, Claude, VS Code and others
Connect when your current plan and client build expose custom Remote MCP servers with OAuth. Availability is controlled by the client vendor.
Bridge not public
stdio-only clients
The one-click native/npm bridge for stdio-only setups such as some Claude Code or Cursor configurations is not part of the public MVP yet.
Pixapi does not claim compatibility with every MCP client. A named client is considered supported only after its full authorization, tool, long-task, and reconnection journey is verified.
Credits and retries
Polling is safe. Generating twice is not a retry.
MCP uses the same Pixapi account balance and model credit rules as the rest of the platform. Current prices come from the live pricing tool and pricing page.
Call pixapi_get_pricing_and_balance before generation to confirm the model cost and available balance.
pixapi_generate_image creates a new task and consumes the credits shown for the selected model.
pixapi_get_task is read-only. Poll the returned task_id until its status is completed or failed.
Generation is currently non-idempotent
Repeating pixapi_generate_image creates another task and can charge the account again. After submission, keep the task_id and poll it; do not automatically resubmit because the result is still processing.
Your account, data, and use remain covered.
By connecting Pixapi MCP, you use the same Pixapi account and accept the policies that govern authentication, prompts, task records, generated media, billing, and service use.