> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lootexplus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server

> Model Context Protocol (MCP) server for Lootex Plus API integration

## Overview

Lootex Plus provides a remote Model Context Protocol (MCP) server that maps all our API endpoints to tools that can be used by any MCP-compatible client, including Claude Code, Gemini CLI, and other MCP clients.

## Getting Started

1. **Obtain an API Key**: Get your API key from the Lootex Plus dashboard
2. **Configure Your MCP Client**: Add the server configuration to your MCP client settings
3. **Test the Connection**: Verify the connection by making a simple prompt like to trigger a tool.

## Configuration

#### MCP Server URL

<Note> [https://mcp.lootexplus.com/mcp](https://mcp.lootexplus.com/mcp)</Note>

### Authentication

All MCP server requests require a valid API key passed in the authorization header. The exact configuration varies across MCP clients.

<Note>
  **Important**: Replace `YOUR_API_KEY` with your actual Lootex Plus API key from the dashboard. The API key should have the necessary permissions for the tools you plan to use.
</Note>

#### Claude Code

To use Lootex Plus MCP in Claude Code, run the following command to setup automatically:

```bash theme={null}
claude mcp add --transport http lootex-plus https://mcp.lootexplus.com/mcp \
  --header "authorization: Bearer YOUR_API_KEY"
```

<Note>
  Visit the [Claude Code MCP documentation](https://docs.anthropic.com/en/docs/claude-code/mcp#option-3%3A-add-a-remote-http-server) for more details on configuration options.
</Note>

#### Gemini CLI

Add the following configuration to your `~/.gemini/settings.json` file:

```json theme={null}
{
  "mcpServers": {
    "lootex-plus": {
      "httpUrl": "https://mcp.lootexplus.com/mcp",
      "headers": {
        "authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

### Test Prompt

```
Show me top 10 collections on chainId 1868 for the past week. Display their names, contractAddress, and verification status in a table.
```

Above prompt should trigger `get_trending_collections` tool.

## Available Tools

The MCP server provides the following tools that wrap the v1 API endpoints:

### Assets

* **`get-asset`** - Retrieve a specific asset by chainId, contractAddress, and tokenId
* **`search-assets`** - Explore assets with comprehensive search filters including owner address, verification status, and listing availability

### Collections

* **`get-collection`** - Retrieve a specific collection by chainId and contractAddress
* **`search-collections`** - Search for collections with filters including verification status
* **`get-trending-collections`** - Get trending collections by chainId and time range (1 hour, 1 day, 1 week, 1 month)

### Orders

* **`get-order`** - Retrieve a specific order by hash
* **`create-orders`** - Create new orders with signature
* **`list-orders`** - List orders for sale with detailed item specifications
* **`buy-orders`** - Purchase orders with specified hashes
* **`cancel-orders`** - Cancel existing orders

### Drops

* **`get-drop`** - Retrieve a specific drop by chainId and contractAddress
* **`claim-drop`** - Claim a drop for a specific address with quantity and recipient options