Remote MCP

ViNano MCP server

Connect an AI client that supports remote MCP to your ViNano account. Your agent can generate and edit images and create videos, sees the price before every charge and pays with your existing credits.

MCP server URL

https://mcp.vinano.ai/api/mcp

Add this URL as a remote MCP server (Streamable HTTP). Sign-in happens in your browser with OAuth.

What agents can do

Generate and edit images

Text-to-image and edits from uploaded reference images, using the same models and prices as the website.

Create videos

Text-to-video and image-to-video with Veo 3.1, Seedance, MiniMax H3 and Grok Imagine.

Quote, track and fetch

Check your balance, get the price before generating, follow task status and fetch finished images and videos.

How to connect

  1. 1In your AI client, add the server URL above as a remote MCP server.
  2. 2When the client asks you to sign in, ViNano opens in your browser. Sign in, choose permissions and set per-task and daily credit limits.
  3. 3Ask your agent to create something. It gets a quote first, then submits the task once.
  4. 4The agent checks the task and returns the image or video. You can revoke the connection at any time on the MCP connections page.

Tools

Tools without a tag only read data. Tools tagged “uses credits” charge the quoted price.

  • list_modelsList image models, sizes and prices.
  • get_balanceRead your credit balance and this connection's limits.
  • prepare_uploadUpload a reference image for edits or image-to-video.
  • quote_imageGet the price of an image task before submitting.
  • generate_imageCreate an image from a text prompt.uses credits
  • edit_imageEdit uploaded images with a text instruction.uses credits
  • list_video_modelsList video models, durations, resolutions and prices.
  • quote_videoGet the price of a video task before submitting.
  • generate_videoCreate a text-to-video or image-to-video task.uses credits
  • get_taskCheck task status and charged credits.
  • get_assetGet a finished image or video.

Who can use it

Accounts that have completed any purchase (a credit pack or a plan) can connect. Existing Team subscriptions and API allowlist accounts keep their access. Without a purchase, buy any credit pack and then connect.

Credits and safety

  • Prices are the same as on the website for paid accounts; MCP adds no surcharge.
  • Each connection has its own per-task and daily credit limit. Daily usage resets at 00:00 UTC.
  • Submitting again with the same idempotency key returns the original task and never charges twice.
  • Connections last 30 days and can be revoked at any time. Failed tasks follow the website's existing refund rules.

Scripts and automation

For scripts that cannot open a browser, create an expiring automation key on the MCP connections page and call the same tools over HTTP at POST /api/agent/v1/{tool}. Keys follow the same permissions and credit limits. Never put a key in a prompt, URL or public config.

Agent setup guide (auth.md)

FAQ

Which AI clients can connect?

Clients that support remote MCP servers over Streamable HTTP with OAuth sign-in. If your client only runs local servers, use the HTTP API with an automation key instead.

Do connecting and checking prices cost credits?

No. Listing models, quotes, balance checks and task status are free. Only the generate and edit tools spend credits, at the quoted price.

Why does my client say access is denied?

MCP is available to accounts with a completed purchase. Buy any credit pack or plan, then connect again. Connections created before video tools were added must reconnect to get video permission.

Can my agent spend more than I allow?

No. A quote above the connection's per-task limit is rejected, and new tasks stop once the daily limit is reached.