Developers

Genghis MCP server

Genghis has a free, read-only MCP server: AI agents can search, price and compare our catalog, then send you to the product page to buy.

MCP (Model Context Protocol) is the open standard AI assistants such as Claude use to call outside tools. With the Genghis server connected, you can ask your assistant which PlayStation card is cheapest, and in which country, and get live prices from our catalog.

What an agent can do with it

The server covers the same catalog as the site: 4,500+ gift cards, prepaid cards, game keys, top-ups and eSIMs for 80+ countries. All prices are in USD.

search_products
Which products match a brand or keyword, in a country, category or price range.
get_product
Every denomination of one product, with its USD price and stock.
compare_across_countries
Where one brand is cheapest across country markets.
list_countries
Which country markets we cover, with product counts.
list_categories
The catalog categories.
how_to_pay
Our terms of purchase, written for the agent to quote as they are.

What it cannot do

It cannot place an order. The server only reads the public catalog: it holds no keys, stores nothing about you and refuses any request that would change data. To buy, the agent gives you the product link and you pay on genghis.pro as usual.

Install

The server runs on your computer and connects to Claude Desktop.

  1. 1. Download the code from GitHub: git clone https://github.com/genghisecommerce/genghis-mcp-readonly
  2. 2. Install it. It needs Python 3.10 or later. bash setup.sh
  3. 3. Register it with Claude Desktop, then quit and reopen the app. bash register.sh

The tools then appear in Claude's connectors menu. The code is open source under the MIT licence.

The terms an agent quotes

  • Pay with Bitcoin, USDT or 300+ other cryptocurrencies.
  • The amount in your coin is shown before you pay. It includes our exchange-rate margin; a network cost applies only to USDT on Tron and to Monero.
  • No KYC at checkout: an email address is all we ask for.
  • Instant delivery: your code appears on screen as soon as the payment confirms on the network. We also email you a link to it.
  • Refunds within 30 days if a code fails at first redemption, arrives incomplete or never arrives, or our page showed the wrong region.

Questions

Does Genghis have an MCP server?

Yes. It is free, open source and read-only, published on GitHub as genghis-mcp-readonly.

Can an AI agent buy gift cards on Genghis?

Not yet. The agent can search and compare, then hands you the product link; you complete the payment in crypto on genghis.pro.

Does the MCP server need an API key?

No. It reads the same public catalog the website shows, so there is nothing to sign up for.

Which AI assistants does it work with?

Any assistant that supports local MCP servers. The install script sets it up for Claude Desktop.

Questions from developers: samantha@genghis.pro