Start

Use with AI (MCP)

Give your AI assistant read access to your Adolfjon account. Ask it "what's my balance?", "did my last order go through?" or "how many boost hours do I have left?" and it calls the API for you with your key.

Everything is read-only. An AI connected here cannot buy, spend, change settings or delete anything. It sees only what your key's permissions allow.

MCP server

Our MCP server lives at https://dev.adolfjon.uz/mcp. It uses the same keys, permissions and limits as the REST API. Tools you have no permission for are hidden from the AI.

Claude Code

Terminal

claude mcp add --transport http adolfjon https://dev.adolfjon.uz/mcp --header "Authorization: Bearer ak_test_YOUR_KEY"

Cursor

Add this to ~/.cursor/mcp.json (or .cursor/mcp.json in your project):

mcp.json

{
    "mcpServers": {
        "adolfjon": {
            "url": "https://dev.adolfjon.uz/mcp",
            "headers": {
                "Authorization": "Bearer ak_test_YOUR_KEY"
            }
        }
    }
}

Claude Desktop and other apps

Apps that only run local MCP servers can use the mcp-remote bridge (needs Node.js). In Claude Desktop: Settings → Developer → Edit config:

claude_desktop_config.json

{
    "mcpServers": {
        "adolfjon": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "https://dev.adolfjon.uz/mcp",
                "--header",
                "Authorization:${ADOLFJON_AUTH}"
            ],
            "env": {
                "ADOLFJON_AUTH": "Bearer ak_test_YOUR_KEY"
            }
        }
    }
}

ChatGPT and agent frameworks

Tools that read OpenAPI work too: GPT Actions in a custom GPT, LangChain, n8n, Make and others.

Import the schema from https://dev.adolfjon.uz/openapi.json.
Authentication: API key, type Bearer, value your ak_… key.
Keep the GPT private: anyone who can use it uses your key.

Tools

Tool	What it does	Needs
`get_key_info`	Shows the API key in use: mode (test or live), permissions, limits and how many requests are left today.	any key
`list_categories`	Lists Adolfjon.uz store categories with product counts.	`catalog:read`
`list_products`	Lists products on sale with prices in UZS. Filter by category id or type.	`catalog:read`
`get_product`	Gets one product by id with price, stock and description.	`catalog:read`
`list_news`	Lists Adolfjon.uz news posts, newest first.	`catalog:read`
`get_profile`	Gets the account profile: nickname, plan, level, linked logins.	`account:read`
`get_balance`	Gets the current balance in UZS.	`balance:read`
`list_transactions`	Lists balance changes: top-ups, purchases, refunds, bonuses.	`balance:read`
`list_orders`	Lists store orders, newest first. Never includes delivered items or keys.	`orders:read`
`get_order`	Gets one order by its order number, e.g. A7K2M9.	`orders:read`
`get_plan`	Gets the VIP / LITE plan, expiry and auto-renew.	`licenses:read`
`get_boost`	Gets Hour Boost plans: hours used and left, games, and whether boosting runs now.	`boost:read`
`list_notifications`	Lists site notifications, newest first.	`notifications:read`

Limits and good habits

Every tool call counts as one API request: 30 per minute and 2 000 per day per key. An agent stuck in a loop gets rate_limited and we alert you.
Start with an ak_test_ key. Account tools then return realistic fake data.
Make a separate key just for AI with only the permissions it needs, so you can revoke it alone.
AI apps on your laptop call from your home IP. Leave the IP allowlist empty for that key, or add your IP.
Every call shows in your request log as MCP /mcp/<tool>.