JustOneAPI MCP Server

Use JustOneAPI in MCP clients such as Codex, Claude Desktop, Cursor, and other AI assistant tools.

JustOneAPI MCP helps your assistant find the right JustOneAPI endpoint, inspect the required parameters, and call the API with your JustOneAPI token.

Supported Clients

You can use JustOneAPI MCP with any MCP-compatible client that supports remote HTTP or local stdio servers, including:

Codex
Claude Desktop
Cursor
Other MCP-compatible AI assistants

For Codex, add JustOneAPI as a remote MCP server and use the Remote HTTP URL and Authorization header below.

Quick Start

Remote HTTP

Remote HTTP is the recommended way to use JustOneAPI MCP.

{
  "mcpServers": {
    "justoneapi": {
      "url": "https://mcp.justoneapi.com/mcp",
      "headers": {
        "Authorization": "Bearer your_token"
      }
    }
  }
}

Local stdio

You can also run the MCP server locally with npx.

{
  "mcpServers": {
    "justoneapi": {
      "command": "npx",
      "args": ["-y", "justoneapi-mcp"],
      "env": {
        "JUSTONEAPI_TOKEN": "your_token"
      }
    }
  }
}

The confidential JUSTONEAPI_PRIVATE_CATALOG_TERMS registry is an operator-only catalog release safeguard. Without it, discovery and schema tools use the release-scanned bundled catalog, and dynamic catalog refresh, promotion, and rollback remain disabled. Runtime API and account calls do not require this registry and return the upstream payload through the normal truncation behavior. Do not copy the registry into shared or public client configuration.

Token

Use your JustOneAPI token in one of these ways:

Authorization: Bearer your_token

or, for local stdio:

JUSTONEAPI_TOKEN=your_token

Bearer your_token is the recommended Authorization format.

Things You Can Ask

Ask your MCP client naturally:

Find the Xiaohongshu note comments API and tell me which parameters are required.

More examples:

Which Douyin APIs can get video details?

Call the Xiaohongshu note comments API with this note ID: xxxxx.

List the Weibo search-related APIs and explain when to use each one.

Continue to the next page of results.

Check my JustOneAPI balance.

Show my recent API usage and spending.

The API returned code 400. Help me check which parameter might be wrong.

The API returned code 601 or 602. What does it mean?

The assistant can search available JustOneAPI endpoints, explain required parameters, call the selected API after you provide the needed values, and help interpret common response codes.

License

MIT

Justoneapi MCP

README