MAY 25 · 2026

Connect NIUA to your AI agent

#mcp#agents

Updated 2026-06-07 — NIUA now connects over OAuth; no API key to paste.

If you work inside an AI agent (Claude, Cursor, Cline), this tutorial gets NIUA wired into your conversation in about two minutes.

Why MCP

NIUA runs a hosted MCP server alongside the REST API. MCP (Model Context Protocol) is the standard way to give an AI agent access to outside tools. Once you connect, your agent can generate images, music, and text-to-motion directly inside its conversation.

Step 1: Connect by URL

The server URL is:

https://mcp.niua.ohao.tech/mcp

Clients with native remote MCP support (Claude): add this URL as a custom connector in your client's settings. A browser tab opens and you sign in with Google or GitHub. No API key, no package to install.

Clients without native remote support (Cursor, Cline): use the community mcp-remote bridge. Paste this block into your client's MCP config:

{
  "mcpServers": {
    "niua": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.niua.ohao.tech/mcp"]
    }
  }
}

On first run, the bridge opens a browser tab to sign in. After that it reuses the saved session.

Step 2: Sign in

Sign in with Google or GitHub at the prompt. Your NIUA account is created automatically if you don't have one. Your wallet starts at zero — top up at /pricing before generating.

Step 3: Verify it works

After connecting (or restarting the client with the bridge config), ask your agent something like "generate an image of a cyberpunk neon street." If the connection worked, the agent will call NIUA's image tool and return a CDN URL within about thirty seconds. If nothing happens, check the client's MCP logs. For re-auth, run the connector setup again or clear ~/.mcp-auth.

What you can do now

Over MCP, your agent has access to five tools: generate image, generate music, generate text-to-motion, check your wallet balance, and look up async jobs. Each generation charges your NIUA wallet in real cents at the prices listed on /pricing. The full generation surface, including mesh, texture, rig, speech, dialogue, and sound effects, is on the REST API.

Updated 2026-07-02: the MCP server now exposes 14 tools covering every modality. Rig is temporarily offline.

Try asking your agent to generate a music loop for a level you're building, or three image references for a character concept. The wallet view in Settings shows every charge as it happens.

Need CI access or want to skip the browser? Get a key from Settings → Developer (starts with niua_live_) and pass it as a header. See the MCP integration guide for the full config.

Back to blog