Skip to content
MCP server

NovAI - Chinese AI Models Gateway

One OpenAI-compatible endpoint for 100+ Chinese AI models, exposed as MCP tools

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
API, CLI
Runs
Locally
Version
0.1.1
Listing updated
2 days ago

About NovAI - Chinese AI Models Gateway

NovAI - Chinese AI Models Gateway is a freemium MCP server for ai models and llm tooling. It runs locally on your machine and is started by your AI client.

NovAI is a gateway to models from Chinese labs, and this package is both a small Python SDK and an MCP server for it. Models come from DeepSeek, Qwen, GLM, Kimi, MiniMax, Hunyuan, Doubao and Seedance, among others, covering chat, image, video, embeddings and more. Any code written for the OpenAI client works by changing the base URL to https://aiapi-pro.com/v1.

The site and README state a 0% platform fee at provider list price, and its model page sets prices next to OpenRouter's. These are the vendor's own comparisons, not independent benchmarks. Five models are marked free, with 10 calls a day on the free tier: glm-4.7-flash, glm-4.6v-flash, glm-4.1v-thinking-flash, cogview-3-flash and cogvideox-flash.

The terms listed include a $5 minimum top-up, 60 requests a minute, a 7-day refund on unused balance and full refunds for failed video or 3D jobs. Chinese image models add a visible AI-generated watermark. Install with pip install aiapi-pro and set NOVAI_API_KEY.

Install

Run in a terminal

claude mcp add novai-python --env NOVAI_API_KEY='<NOVAI_API_KEY>' -- uvx aiapi-pro

Add to claude_desktop_config.json

{
  "mcpServers": {
    "novai-python": {
      "command": "uvx",
      "args": [
        "aiapi-pro"
      ],
      "env": {
        "NOVAI_API_KEY": "<NOVAI_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "novai-python": {
      "command": "uvx",
      "args": [
        "aiapi-pro"
      ],
      "env": {
        "NOVAI_API_KEY": "<NOVAI_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "novai-python": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "aiapi-pro"
      ],
      "env": {
        "NOVAI_API_KEY": "<NOVAI_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "novai-python": {
      "command": "uvx",
      "args": [
        "aiapi-pro"
      ],
      "env": {
        "NOVAI_API_KEY": "<NOVAI_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "novai-python": {
      "command": "uvx",
      "args": [
        "aiapi-pro"
      ],
      "env": {
        "NOVAI_API_KEY": "<NOVAI_API_KEY>"
      }
    }
  }
}

Configuration

  • NOVAI_API_KEYNovAI API key. Get $2 free credit (no card) at https://aiapi-pro.com/registerRequired

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

novai_list_models
Lists the available models.
novai_chat
Sends a chat request to a chosen model.
novai_generate_image
Generates an image with a chosen model.
novai_free_models
Lists the models that are free to use.
novai_cheapest
Finds the cheapest model.
novai_pricing_feed
Returns the live pricing feed.
novai_transparency
Returns the gateway's published terms.

What it does

OpenAI-compatible API
Swap one base URL line in existing OpenAI code.
Many model families
Chat, vision, image, video and OCR models from several labs.
Free models
Five models can be used without credit charge, within daily limits.
Live pricing feed
Tools return current prices and the cheapest chat model.
Transparent terms
Published fee, rate limit and refund terms in a machine-readable file.
MCP and SDK
Same models as MCP tools or Python functions.

Good for

  • Try Chinese models from Claude Desktop or Cursor
  • Find the cheapest model for a task from inside a chat
  • Generate images with a free model
  • Compare gateway prices against OpenRouter
  • Switch an existing OpenAI-based app to other models

Pricing

Freemium

$2 free credit, five free models; otherwise pay per use at provider list price, $5 minimum top-up

Prices change. Check aiapi-pro.com before you buy.

NovAI - Chinese AI Models Gateway FAQ

How do I get started?

Register for $2 of free credit with no card, install `aiapi-pro` and set `NOVAI_API_KEY`.

What does the MCP server expose?

Seven tools including `novai_chat`, `novai_generate_image` and `novai_pricing_feed`.

What are the limits?

60 requests a minute, a $5 minimum top-up, and 10 calls a day on the free models.

Is the SDK open source?

The README lists an MIT license.

What if a video job fails?

Failed video and 3D jobs are refunded in full.

Is NovAI - Chinese AI Models Gateway free?

NovAI - Chinese AI Models Gateway has a free plan, with paid plans for more usage or features.

How do I add NovAI - Chinese AI Models Gateway to Claude Code?

Run this command in your terminal: claude mcp add novai-python --env NOVAI_API_KEY='<NOVAI_API_KEY>' -- uvx aiapi-pro

What are the best alternatives to NovAI - Chinese AI Models Gateway?

The closest alternatives to NovAI - Chinese AI Models Gateway are Claude Code Ultimate Guide, signafAIde, Toolkien, Lugh and HypePaper.

Alternatives to NovAI - Chinese AI Models Gateway

  1. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  2. signafAIde

    MCP server

    Local MCP server to set up, verify and check coverage of signed agent action records

    Runs locally
    • 5 tools
    • Freemium
    • Security
  3. Toolkien

    MCP server

    One MCP gateway for all your MCP servers, with code mode, permissions and audit

    Not checked yet
    • 3 tools
    • Remote
    • Open source
    • AI models and LLM tooling
  4. Lugh

    MCP server

    Write, check and dry-run Lugh agent programs with policy, budgets and approvals

    Runs locally
    • 5 tools
    • Open source
    • AI models and LLM tooling
  5. HypePaper

    MCP server

    Research papers, benchmarks, citations and topic experts for AI assistants

    • 58 tools
    • Remote
    • Freemium
    • AI models and LLM tooling