Birinchi Shop MCP

An official MCP server for Birinchi Shop, an Uzbekistan-based online store and CPA affiliate platform. It allows AI agents to search for products, retrieve product details, access store information, place orders with customer confirmation, and check order statuses. The server supports both partner API authentication and OAuth 2.1 for shoppers, facilitating e-commerce interactions and affiliate management.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Vendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-01Operated by Birinchi Shop

MCP endpoint (Streamable HTTP)

https://birinchishop.uz/api/shop/mcp

Vendor documentation

What you can do with it

Search for products in the Uzbekistan catalog
Retrieve detailed product information and pricing
Place orders with explicit customer confirmation
Check the status of existing orders

Source and maintenance

Vendor evidenceRegistry 1.0.0

mcp-registry: uz.birinchishop/shop@1.0.0 Project website

Protocol and capabilities

Server: birinchishop-store 1.1.0
MCP protocol: 2025-06-18
Tools: 5 advertised
Resources: 2 advertised
Resource templates: 0 advertised
Prompts: Not advertised

Server-advertised capabilities

{
  "tools": {
    "listChanged": false
  },
  "resources": {
    "listChanged": false
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Birinchi Shop (birinchishop.uz) is an online store in Uzbekistan. Every product is delivered to all regions of Uzbekistan in 1-3 days and paid in CASH to the courier on delivery (no online payment). A delivery fee of 30000 UZS is added to the product price. How to help a shopper: 1. search_products to find items (names are in Uzbek/Russian — search in those languages too, e.g. "soat", "часы"). get_product for details, variants (size/color) and the total to pay. 2. Show the price in UZS, the delivery fee and the total. Mention that payment is cash on delivery. 3. Only when the shopper explicitly asks to order: collect their name, their Uzbekistan mobile phone (+998XXXXXXXXX) and region, repeat the product, variant and total back to them, and get a clear "yes". Then call place_order with customer_confirmed=true. 4. After ordering tell the shopper: an operator will call this number shortly to confirm; keep the phone on. Never invent phone numbers or place test/sample orders — every order is phoned by a real call center. Prices are integers in UZS.

Tools

5 advertised

search_products — Search products

Advertised by the server during the last successful anonymous check.

Advertised read-only

Search the store catalog. Returns title, price (UZS), delivery fee, availability, url and image. Product names are in Uzbek or Russian; short keywords in either language match best.

search_products input schema

{
  "type": "object",
  "properties": {
    "sort": {
      "enum": [
        "popular",
        "newest",
        "price_asc",
        "price_desc"
      ],
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Default 10."
    },
    "query": {
      "type": "string",
      "maxLength": 80,
      "description": "Keywords, e.g. \"karcher\", \"soat\", \"наушники\". Empty = popular products."
    },
    "max_price": {
      "type": "integer",
      "minimum": 0,
      "description": "Maximum product price in UZS."
    },
    "min_price": {
      "type": "integer",
      "minimum": 0
    }
  },
  "additionalProperties": false
}

search_products annotations

{
  "title": "Search products",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

get_product — Product details

Advertised by the server during the last successful anonymous check.

Advertised read-only

Full product details: description, all images, video, variants (size/color with their own price and availability), delivery terms and the total to pay.

get_product input schema

{
  "type": "object",
  "required": [
    "product_id"
  ],
  "properties": {
    "product_id": {
      "type": "integer",
      "minimum": 1
    }
  },
  "additionalProperties": false
}

get_product annotations

{
  "title": "Product details",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

store_info — Delivery, payment and returns

Advertised by the server during the last successful anonymous check.

Advertised read-only

Store policies: delivery area, time and fee, cash-on-delivery payment, how orders are confirmed, returns and support contact.

store_info input schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

store_info annotations

{
  "title": "Delivery, payment and returns",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

place_order — Place a REAL order (cash on delivery)

Advertised by the server during the last successful anonymous check.

Open-world

Places a real cash-on-delivery order for the shopper. A call-center operator phones the given number to confirm, then a courier delivers and collects payment. The order is accepted only with customer_confirmed=true, meaning the shopper explicitly confirmed the product, variant, total and phone number.

place_order input schema

{
  "type": "object",
  "required": [
    "product_id",
    "customer_name",
    "customer_phone",
    "region",
    "customer_confirmed"
  ],
  "properties": {
    "agent": {
      "type": "string",
      "maxLength": 60,
      "description": "Name of the assistant placing the order, e.g. \"ChatGPT\"."
    },
    "region": {
      "type": "string",
      "maxLength": 64,
      "description": "Region (viloyat) or city in Uzbekistan."
    },
    "product_id": {
      "type": "integer",
      "minimum": 1
    },
    "variant_id": {
      "type": "integer",
      "minimum": 1,
      "description": "Required if the product has variants; variant ids are listed in the product details."
    },
    "customer_name": {
      "type": "string",
      "maxLength": 100,
      "minLength": 2
    },
    "customer_phone": {
      "type": "string",
      "maxLength": 20,
      "description": "Uzbekistan mobile number, +998XXXXXXXXX."
    },
    "variant_type_id": {
      "type": "integer",
      "minimum": 1,
      "description": "Required if the chosen variant has types."
    },
    "customer_confirmed": {
      "type": "boolean",
      "description": "Must be true: the shopper explicitly confirmed this order."
    }
  },
  "additionalProperties": false
}

place_order annotations

{
  "title": "Place a REAL order (cash on delivery)",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

get_order_status — Order status

Advertised by the server during the last successful anonymous check.

Advertised read-only

Status of an order placed earlier. Requires the order id and the last 4 digits of the customer's phone.

get_order_status input schema

{
  "type": "object",
  "required": [
    "order_id",
    "phone_last4"
  ],
  "properties": {
    "order_id": {
      "type": "integer",
      "minimum": 1
    },
    "phone_last4": {
      "type": "string",
      "pattern": "^\\d{4}$"
    }
  },
  "additionalProperties": false
}

get_order_status annotations

{
  "title": "Order status",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

2 advertised

birinchi-shop-store — Birinchi Shop store view

Advertised by the server during the last successful anonymous check.

Product cards, product details with order form, order status.

birinchi-shop-store URI

ui://birinchi-shop/store-v5.html

MIME type: text/html;profile=mcp-app

birinchi-shop-store — Birinchi Shop store view

Advertised by the server during the last successful anonymous check.

Product cards, product details with order form, order status.

birinchi-shop-store URI

ui://birinchi-shop/store-v5.skybridge.html

MIME type: text/html+skybridge

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks: 1 of 1 (100%)
Average latency: 1512 ms
95th percentile latency: 1512 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

Nov 1, 2026, 7:17 AM UTC · probe · passed · 1512 ms · metadata changed · 5 tool(s), 2 resource(s), 0 resource template(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.

Claude Code configuration

claude mcp add --transport http birinchi-shop-mcp-birinchishop https://birinchishop.uz/api/shop/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).

Codex configuration

codex mcp add birinchi-shop-mcp-birinchishop --url https://birinchishop.uz/api/shop/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable birinchi-shop-mcp-birinchishop in your MCP settings.

Cursor configuration

{
  "mcpServers": {
    "birinchi-shop-mcp-birinchishop": {
      "url": "https://birinchishop.uz/api/shop/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).

Cline configuration

{
  "mcpServers": {
    "birinchi-shop-mcp-birinchishop": {
      "type": "streamableHttp",
      "url": "https://birinchishop.uz/api/shop/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start birinchi-shop-mcp-birinchishop and inspect its tools.

VS Code configuration

{
  "servers": {
    "birinchi-shop-mcp-birinchishop": {
      "type": "http",
      "url": "https://birinchishop.uz/api/shop/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.

Gemini CLI configuration

gemini mcp add --transport http birinchi-shop-mcp-birinchishop https://birinchishop.uz/api/shop/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.

Claude Desktop configuration

{
  "mcpServers": {
    "birinchi-shop-mcp-birinchishop": {
      "url": "https://birinchishop.uz/api/shop/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.

Windsurf configuration

{
  "mcpServers": {
    "birinchi-shop-mcp-birinchishop": {
      "serverUrl": "https://birinchishop.uz/api/shop/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Birinchi Shop MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows

See all 981

Do you run Birinchi Shop MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing

Birinchi Shop MCP

Endpoint and access

What you can do with it

Source and maintenance

Protocol and capabilities

Server-provided instructions

Tools

Prompts

Resources

30-day availability

Maintenance history

Connect from your client

Claude Code

Codex

Cursor

Cline

VS Code

Gemini CLI

Claude Desktop

Windsurf

Let your agent find its tools

Other commerce servers

Do you run Birinchi Shop MCP?