fortem-community-mcp

A community MCP (Model Context Protocol) server for the Fortem NFT marketplace.

⚠️ This is an unofficial community project, not affiliated with FortemLabs.

Connect Claude to Fortem and control your NFTs with natural language — create collections, mint items, manage your kiosk, and list items for sale. Also includes developer tools for integrating Fortem into your game or app.

Quick Start

Step 1 — Get your Sui private key

You need a Sui wallet private key to authenticate. Export it from your wallet app:

• Sui Wallet → Settings → Accounts → Export Private Key
• Suiet → Settings → Export Private Key

The key starts with suiprivkey1...

⚠️ Keep this key safe. Anyone who has it can control your wallet.

Step 2 — Connect to Claude

Claude Code (terminal):

claude mcp add fortem-community \
  -e SUI_PRIVATE_KEY=suiprivkey1... \
  -- npx fortem-community-mcp

Claude Desktop — edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "fortem-community": {
      "command": "npx",
      "args": ["fortem-community-mcp"],
      "env": {
        "SUI_PRIVATE_KEY": "suiprivkey1..."
      }
    }
  }
}

Restart Claude Desktop after saving.

Step 3 — Start using it

Open Claude and try:

Show my Fortem collections

Available Tools

Personal — Manage your own NFTs

These tools act on your own account (wallet address tied to SUI_PRIVATE_KEY).

| Tool | What it does | |------|-------------| | create_collection | Create a new NFT collection | | mint_item | Mint an NFT item into a collection | | upload_image | Upload an image for an item or collection | | ensure_kiosk | Create a kiosk if you don't have one (required before listing) | | list_item | List an NFT item for sale | | get_my_collections | View your collections | | get_collection_detail | View details of a specific collection | | get_my_items | View your NFT inventory | | get_item_detail | View details of a specific item |

Developer — Integrate Fortem into your game or app

Use these tools when building a game or app that uses Fortem for monetization, NFT rewards, or item management.

| Tool | What it does | |------|-------------| | get_developer_guide | Get an integration guide with your actual API key (Direct API / JS SDK / Unity SDK) | | get_my_api_key | View your Developer API key, or regenerate it (regenerate: true) | | verify_member | Check if a wallet address is a registered Fortem member | | get_my_profile | Get your Fortem account profile |

Example Prompts

Personal use:

Show me my Fortem collections

Create a new collection called "Summer Drop" with description "Limited edition summer NFTs"

Mint 10 items called "Summer Pass" in collection #5

Check if I have a kiosk, create one if I don't

List item #42 for 10 USDC

Show my items with status MINTED

Developer / game integration:

Show me the Fortem developer integration guide

I want to build an HTML5 game with Fortem — which SDK should I use?

Show me how to integrate Fortem into my Unity game

Is wallet 0xabc... a registered Fortem member?

What account is this MCP server authenticated as?

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | SUI_PRIVATE_KEY | — | Required. Your Sui wallet private key (suiprivkey1...) | | FORTEM_NETWORK | testnet | testnet or mainnet |

Testnet vs Mainnet

• Use testnet to try things out without real assets → testnet.fortem.gg
• Use mainnet when working with real NFTs → fortem.gg

# Testnet (default)
claude mcp add fortem-community \
  -e SUI_PRIVATE_KEY=suiprivkey1... \
  -- npx fortem-community-mcp

# Mainnet
claude mcp add fortem-community \
  -e FORTEM_NETWORK=mainnet \
  -e SUI_PRIVATE_KEY=suiprivkey1... \
  -- npx fortem-community-mcp

Authentication

On startup, the server automatically:

1. Verifies your wallet is registered on Fortem
2. Signs a login message with your private key
3. Obtains a JWT access token
4. Re-authenticates transparently if the token expires

Note: Your Fortem account must be created at fortem.gg before using the MCP server.

Development / Debugging

Use MCP Inspector to call tools interactively in your browser:

npx @modelcontextprotocol/inspector \
  -e SUI_PRIVATE_KEY=suiprivkey1... \
  npx fortem-community-mcp

Open http://localhost:5173.

Project Structure

src/
├── index.ts        — Entry point: auth, tool registration, server startup
├── auth.ts         — Ed25519 authentication flow
├── client.ts       — HTTP client with automatic token refresh
├── signer.ts       — Transaction signing abstraction
├── types.ts        — Shared types and network config
└── tools/
    ├── collection.ts  — [Personal] create_collection, get_my_collections, get_collection_detail
    ├── item.ts        — [Personal] upload_image, mint_item, get_my_items, get_item_detail
    ├── kiosk.ts       — [Personal] ensure_kiosk
    ├── market.ts      — [Personal] list_item
    └── developer.ts   — [Developer] get_developer_guide, get_my_api_key, verify_member, get_my_profile