# xsolana

> xsolana is an open-source MCP server for games and play. Design, check, simulate and launch Solana game economies from a JSON spec. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API
- **Website:** https://xgames.fun/solana
- **Repository:** https://github.com/xgamesfun/solana-kit
- **MCP Registry name:** io.github.XGamesFun/solana-kit
- **Categories:** games and play, finance and payments
- **Listing updated:** 2026-11-14

## About

Loot boxes, gacha, shops, lotteries, auctions, NFT staking farms, crafting and capped rewards are described as a JSON spec running on one shared Solana program called loot, so you do not write a new Anchor contract. An agent can design, check, simulate and price one from a sentence.

The checker refuses what the program would refuse, the simulation shows where money goes day by day, and a review notes what a cheater could gain. Loot box rolls use a VRF oracle. An approve step lists every transaction with its cost and sends nothing; running again with its code sends exactly that, signed by a key file on your computer.

It defaults to devnet. Mainnet requires the spec to say so and then uses real money. The program is not yet independently audited.

## Features

- **JSON economy specs:** Describe mechanics without a contract.
- **Spec checker:** Refuses what the program would refuse.
- **Simulation:** Shows money flow day by day.
- **Cheat review:** Notes what an exploiter could get.
- **Approve then send:** Lists transactions before sending.
- **Devnet default:** Mainnet only when the spec says so.

## Good for

- Prototype a loot box with odds
- Price an NFT staking farm
- Check a raffle design
- Launch a capped rewards program

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http solana-kit https://xgames.fun/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://xgames.fun/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "solana-kit": {
      "url": "https://xgames.fun/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "solana-kit": {
      "type": "http",
      "url": "https://xgames.fun/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "solana-kit": {
      "serverUrl": "https://xgames.fun/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "solana-kit": {
      "type": "http",
      "url": "https://xgames.fun/mcp"
    }
  }
}
```

## Tools

- `xsolana_guide`: Read this first whenever someone wants a web3 economy, game economy, token economy, NFT mechanic or onchain reward system: a shop, loot boxes or packs, gacha, a lottery or raffle, an auction (highest bid wins, the outbid refunded at once), staking or a farm, crafting or merging, seasons and emissions, a prediction pool or contest, quests and airdrops, holder-gated drops, using NFTs of any other co
- `xsolana_examples`: Find an economy to start from. With `query` (the person’s own words, as they said them), returns the closest worked examples (whole specs that check and go live in the tests), the closest of 112 real or trending economies rated against loot (great / some / a-lot / cannot, with what carries it or what is missing), and what loot can’t do exactly in the ask, each with the nearest versions it can. Cal
- `xsolana_check`: Check an economy spec: refusals (each with a code, what it means and its fix) stop it from going live; warnings are what the person must hear (chance that pays money, revenue paid to stakers, an unfunded prize, a grant without limits, a mint’s powers, a time far off with its date in words, a token a player can hold a payment up in, a box longer than one answer of the oracle’s holds). The program r
- `xsolana_simulate`: The quick simulation (expected values from the spec, instant): what each box, ticket and craft gives back against its price, the house edge, each pool’s money in and out per day and whether it runs dry, settles or grows, farm rewards per unit staked, what players, the treasury and the platform get each day; a box’s chances with its odds rules at their most, what a box that gives nothing for a miss
- `xsolana_cost`: What going live costs (each account’s rent, the program’s fees, network fees, the seeds, the transactions it takes) and what each action costs whoever signs it while it runs.
- `xsolana_explain`: The economy in plain words for the person: what players do and what it costs and is worth, how the pools fill and drain, what runs by itself, what the authority must sign, what going live costs, and what is flagged for the law. Tell them the essentials in a few lines, from this text.
- `xsolana_review`: Review an economy the way a cheater reads it, before it goes live (not a validity check: xsolana_check is that). For every route that pays or gives value it says who can trigger it, what the program enforces, what it trusts off the chain, and the most one cheater gets; then findings with stable ids and a severity; then the trade-off to show the person: for each grant paid on vouchers, whether its 
- `xsolana_status`: A live economy as it is on chain: the project, every pool’s balance, every record the spec names (found or missing). Reads the economy’s own cluster: devnet through its public RPC (or XSOLANA_RPC_URL), mainnet through XSOLANA_RPC_URL, which must then name a mainnet RPC.
- `xsolana_token`: A token made elsewhere, as the chain has it, for an economy that uses it: give its mint’s address and get its ready `tokens` entry (`source: "existing"`) with its name, ticker, decimals and token program, and `powers` filled in: what the mint’s own keys can do (mint more, freeze, a transfer fee, a transfer hook, a permanent delegate, a pause…), in words too. Use it instead of asking the person to 
- `xsolana_client`: How an app (a game, a site, a bot) uses a live economy: the program’s address and cluster, the npm package and IDL, and the calls a page makes with the player’s own wallet (open a box, buy, stake, craft, enter, claim). Use this instead of writing chain code from memory.

## FAQ

### Is it audited?

No, the program is not yet independently audited.

### Which network?

Devnet by default; mainnet only if the spec says so.

### Do I write a smart contract?

No, economies run on one shared program.

### Is xsolana free?

Yes. xsolana is open source, so you can use and self-host it for free.

### How do I add xsolana to Claude Code?

Run this command in your terminal: claude mcp add --transport http solana-kit https://xgames.fun/mcp

### What are the best alternatives to xsolana?

The closest alternatives to xsolana are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, AvatarSay — Fictional Character & Talking Video MCP and VfxSmith.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.

---
Source: https://ai-powered.com/mcp/xsolana
