Orauria AIAI Creative Studio
Cursor · Claude · Codex

Connect Orauriato your chat client

Create an sk- API key, add Orauria as an MCP server, then chat with Cursor, Claude, or Codex — image, video, and LLM tools bill your Orauria wallet.

  • Works with Cursor, Claude Code / Desktop, and Codex
  • Auth with your Profile sk- API key
  • Same Studio prices — billed to your Orauria wallet
Add to CursorCreate an API key

Click Add to Cursor, then replace sk-YOUR_ORAURIA_API_KEY in the Authorization header with the key from Profile.

Cursor · Claude · Codex

You

Check my credit balance, then generate a soft-daylight product poster.

MCP tools

get_wallet → generate_image

Result

Balance OK · image URL ready · billed to your wallet

You stay in the chat client. Orauria runs the tools and deducts credits.

Cursor · Claude · Codex

How to connect

Three steps from API key to chat in your agent.

  1. 01

    Create an API key

    Open Profile → API keys, create a key, and copy sk-… It is shown only once.

  2. 02

    Add MCP to your client

    Connect Cursor, Claude, or Codex with the config below.

  3. 03

    Chat and call tools

    Ask the agent to chat, generate, or check wallet. Credits come from your Orauria balance.

What you can do

Same Studio capabilities, called from your local chat client via MCP.

  • Generate images

    Prompt a model from your agent. Cost follows Studio pricing.

  • Generate video

    Start a video job, poll until it finishes, then open the result URL.

  • Chat with LLMs

    Use Orauria chat models from MCP. Token usage is billed to your wallet.

Connect by client

Pick Cursor, Claude, or Codex — same sk- API key for all.

Cursor

One-click install, or paste JSON into MCP settings.

Add to Cursor
  1. 1

    Create an Orauria API key

    Sign in, open Profile → API keys, create a key, and copy sk-… Keep it private.

  2. 2

    Open Cursor MCP settings

    Cursor Settings → MCP. Use Add to Cursor on this page, or create .cursor/mcp.json.

  3. 3

    Replace the placeholder key

    Put your real sk-… into the Authorization Bearer header. URL is this site plus /api/mcp.

  4. 4

    Refresh MCP and try a prompt

    Enable the orauria server, then ask the agent to list models or generate an image.

Cursor MCP config

.cursor/mcp.json

{
  "mcpServers": {
    "orauria": {
      "url": "http://orauria.com/api/mcp",
      "headers": {
        "Authorization": "Bearer sk-YOUR_ORAURIA_API_KEY"
      }
    }
  }
}

Claude

Claude Code via .claude.json, or Claude Desktop via mcp-remote.

  1. 1

    Create an Orauria API key

    Copy sk-… from Profile → API keys.

  2. 2

    Claude Code

    Merge the HTTP MCP entry into ~/.claude.json (or project config), then restart Claude Code.

  3. 3

    Claude Desktop

    Use the mcp-remote command as a stdio bridge with your Bearer sk-… key, then restart Claude Desktop.

Claude Code config

.claude.json

{
  "mcpServers": {
    "orauria": {
      "type": "http",
      "url": "http://orauria.com/api/mcp",
      "headers": {
        "Authorization": "Bearer sk-YOUR_ORAURIA_API_KEY"
      }
    }
  }
}

Claude Desktop (mcp-remote)

mcp-remote

npx -y mcp-remote http://orauria.com/api/mcp --header "Authorization: Bearer sk-YOUR_ORAURIA_API_KEY"

Codex

Configure model_providers in ~/.codex/config.toml (OpenAI Responses API) — preferred over MCP.

  1. 1

    Create an Orauria API key

    Copy sk-… from Profile → API keys (wallet must have credit).

  2. 2

    Edit ~/.codex/config.toml

    Set model_provider = orauria and base_url = {site}/api/v1 with wire_api = responses.

  3. 3

    Paste sk- into experimental_bearer_token

    Replace sk-YOUR_ORAURIA_API_KEY with your real key. Local: http://localhost:3000/api/v1

  4. 4

    Run Codex and try

    Codex calls /responses through Orauria — billed to your wallet when usage lands.

Codex config.toml (recommended)

~/.codex/config.toml

model = "tt-5.6-sol"
model_reasoning_effort = "high"
model_provider = "orauria"

[model_providers.orauria]
name = "Orauria"
base_url = "http://orauria.com/api/v1"
experimental_bearer_token = "sk-YOUR_ORAURIA_API_KEY"
wire_api = "responses"

Codex CLI

codex mcp add

codex mcp add orauria --url http://orauria.com/api/mcp --bearer-token-env-var ORAURIA_API_KEY

Codex env var

.zshrc / .bashrc

export ORAURIA_API_KEY='sk-YOUR_ORAURIA_API_KEY'

Replace sk-YOUR_ORAURIA_API_KEY with the sk-… key from Profile. The key stays in your local client config — Orauria never asks you to paste it into this page.

Tools the agent can call

Each call uses your API key and bills the matching Studio price.

  • generate_image

    Create an image from a prompt and model. Returns a result URL.

  • generate_video

    Start a video job. Poll until the result URL is ready.

  • chat

    Chat with an Orauria LLM. Billed per token.

  • list_models

    See available image, video, and chat models.

  • get_wallet

    Check remaining credits before you generate.

  • get_task

    Poll an image or video job until it finishes.

FAQ

Does MCP usage cost credits?+

Yes. MCP is only a connector. Image, video, and chat use the same wallet and prices as Studio. If credit is too low, the call returns an error.

Which API key do I use?+

Use the sk-… key from Profile → API keys. Legacy ora_live_… keys still work, but new keys are sk-…

Where do I get an API key?+

Profile → API keys after you sign in. The full key is shown only once. Paste sk-… into your MCP Authorization header (or ORAURIA_API_KEY for Codex).

Can I use Cursor, Claude, and Codex together?+

Yes. The same sk-… key and /api/mcp endpoint work across clients. Create extra keys in Profile if you want separate limits.

Connect your chat client with your Orauria wallet

Create an sk- API key, add MCP in Cursor, Claude, or Codex, then ask the agent to work.

Add to CursorCreate API key