funpay-mcp

Overview

The funpay-mcp server provides comprehensive integration with FunPay.com through the Model Context Protocol. It enables users to manage multiple seller profiles using OS keychain storage, perform CRUD operations on lots, and clone items across subcategories efficiently. The server handles FunPay's specific authentication requirements including golden_key cookies and CSRF tokens while maintaining session persistence through cookie jars. Built with TypeScript and Bun, it leverages modern runtime features like Bun.secrets for secure credential management.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• set_golden_key

  Save/update a profile with golden_key to OS keychain

  Try:Save my golden_key profile named defaultTry:Update my FunPay authentication key
• list_profiles

  List saved profiles with masked keys and active status

  Try:Show me all my saved FunPay profilesTry:List available profiles
• use_profile

  Switch active profile

  Try:Switch to my ci profileTry:Make the work profile active
• delete_profile

  Remove a profile and its keychain entry

  Try:Delete my old FunPay profileTry:Remove the test profile
• whoami

  Verify authentication and return user ID/CSRF info

  Try:Check my current FunPay account statusTry:Show my user details
• get_lot

  Get compact view of a lot's offerEdit form

  Try:Show me details for lot 12345Try:Get information about my offer 68907961
• get_lot_raw

  Get full JSON dump of a lot (higher token cost)

  Try:Get raw JSON data for lot 12345Try:Export full details of my offer
• get_node_schema

  List select-field options for a subcategory

  Try:Show me the form options for subcategory 4187Try:Get the field options for game lots
• create_lot

  Create a new offer in a specified node

  Try:Create a new lot in subcategory 4187Try:Post a new FunPay offer
• update_lot

  Edit an existing offer (price, stock, text, images)

  Try:Update the price of lot 12345Try:Edit my offer's description and images
• clone_lot

  Copy one lot into multiple target nodes with overrides

  Try:Clone lot 68907961 to 4 different subcategoriesTry:Duplicate my offer to multiple nodes with different fields

Comparable tools

Installation

git clone https://github.com/DKeken/funpay-mcp.git
cd funpay-mcp
bun install

{
  "mcpServers": {
    "funpay": {
      "type": "stdio",
      "command": "bun",
      "args": ["run", "/absolute/path/to/funpay-mcp/index.ts"],
      "env": {}
    }
  }
}

FAQ

How do I get my FunPay golden_key?

Sign in at funpay.com, open DevTools → Application → Cookies → funpay.com, and copy the golden_key value.

Where are my credentials stored?

Credentials are stored in the OS keychain (macOS Keychain/Linux libsecret/Windows Credential Manager) when Bun.secrets is available, otherwise in a config file.

Compare funpay-mcp with