badmuriss/csfloat-mcp

CSFloat MCP Server

An MCP (Model Context Protocol) server for accessing CSFloat CS2 skin market data with advanced deal analysis and wear condition support.

Features

• Search skins by name: Find specific CS2 skins with exact market hash names
• Search by weapon type: Search all skins for a specific weapon using def_index
• Automatic wear condition detection: Parse wear conditions from queries (e.g., "AK-47 Field-Tested")
• Deal analysis: Shows percentage above/below predicted price with SP (Sticker Price) calculations
• Price and float filtering: Filter by price range and float values
• Browse market: Browse all available listings with advanced filters
• Get listing details: Get detailed information about specific listings with deal analysis

Setup

1. Install dependencies:

   pip install -r requirements.txt
   

2. Set your CSFloat API key:

   export CSFLOAT_API_KEY="your_api_key_here"
   

   Get your API key from your CSFloat profile settings.

3. Test the server:

   python test_server.py
   

Usage

Run the MCP server:

python csfloat_mcp_server.py

Available Tools

search_skins

Search for CS2 skins by exact name with wear condition. Automatically redirects to weapon search if only weapon name is provided.

Parameters:

• skin_name (required): Full skin name with wear condition (e.g., "AK-47 | Redline (Field-Tested)")
• limit: Number of results (max 50, default 20)
• sort_by: Sort order (best_deal, lowest_price, highest_price, lowest_float, highest_float, most_recent, highest_discount, expires_soon)
• min_price, max_price: Price range in USD
• min_float, max_float: Float value range (0.0-1.0)
• include_auctions: Include auction listings (default: False)

search_by_weapon

Search for all skins of a specific weapon type using def_index. Supports automatic wear condition parsing.

Parameters:

• weapon_name (required): Weapon name, optionally with wear condition (e.g., "AK-47", "AK-47 Field-Tested", "Karambit FN")
• limit: Number of results (max 50, default 20)
• sort_by: Sort order (best_deal, lowest_price, highest_price, lowest_float, highest_float, most_recent, highest_discount, expires_soon)
• min_price, max_price: Price range in USD
• min_float, max_float: Float value range (0.0-1.0) - overrides wear condition if specified
• include_auctions: Include auction listings (default: False)

get_listing_details

Get detailed information about a specific listing with deal analysis.

Parameters:

• listing_id (required): The ID of the listing

browse_market

Browse the general market with filters.

Parameters:

• page: Page number for pagination (default 0)
• limit: Results per page (max 50, default 20)
• sort_by: Sort order
• min_price, max_price: Price range filters

ask_clarifying_questions

Get help with vague queries and search suggestions.

Parameters:

• query (required): Your general query or request

get_wear_conditions_help

Get information about CS2 skin wear conditions and proper formatting.

Wear Condition Float Ranges

The server automatically applies appropriate float ranges when wear conditions are detected:

• Factory New (FN): 0.00 – 0.07
• Minimal Wear (MW): 0.07 – 0.15
• Field-Tested (FT): 0.15 – 0.37
• Well-Worn (WW): 0.37 – 0.44
• Battle-Scarred (BS): 0.44 – 1.00

Examples

# Search for specific skin with exact name and wear condition
search_skins(skin_name="AK-47 | Redline (Field-Tested)", max_price=50, sort_by="best_deal")

# Search all AK-47 skins (any skin pattern)
search_by_weapon(weapon_name="AK-47", limit=10, sort_by="lowest_price")

# Search AK-47 skins with specific wear condition (auto-applies float range 0.15-0.37)
search_by_weapon(weapon_name="AK-47 Field-Tested", max_price=100, sort_by="best_deal")

# Search Karambit Factory New (auto-applies float range 0.00-0.07)
search_by_weapon(weapon_name="Karambit FN", sort_by="lowest_float")

# Get details for a specific listing with deal analysis
get_listing_details(listing_id="890602542927580927")

# Browse market sorted by best deals
browse_market(limit=10, sort_by="best_deal")

Deal Analysis Features

Each listing shows:

• Price vs Predicted: Percentage above/below CSFloat's predicted price
• SP (Sticker Price): For overpriced items with stickers, shows what % of sticker value you're paying as overpay
• Good Deal Detection: Highlights listings significantly below predicted price
• Sticker Values: Individual sticker prices and total sticker value