npm install @deansasek/pricecharting-api

import { PriceChartingClient } from '@deansasek/pricecharting-api/sdk';

const client = new PriceChartingClient({ requestDelay: 500 });

// Search for products
const results = await client.search('charizard', { category: 'pokemon-cards' });

// Get full product pricing data
const product = await client.getProductPrice('pokemon-scarlet-&-violet-151', 'charizard-ex-199');

// Get product metadata
const meta = await client.getProductMeta('pokemon-scarlet-&-violet-151', 'charizard-ex-199');

// Get available categories
const categories = await client.getCategories();

// Get groups/sets within a category
const groups = await client.getGroupList('pokemon-cards');

import { PriceChartingClient } from '@deansasek/pricecharting-api/sdk';

const client = new PriceChartingClient();

async function analyzeProduct(gameSlug: string, productSlug: string) {
  const result = await client.getProductPrice(gameSlug, productSlug);

  if (!result.success) {
    console.error('Failed to fetch product:', result.error);
    return;
  }

  console.log(`Product: ${result.cardName}`);
  console.log(`Category: ${result.category}`);
  console.log(`Grades available: ${result.grades.length}`);

  // Print grade prices
  for (const grade of result.grades) {
    console.log(`  ${grade.grade}: ${grade.price}`);
  }

  return result;
}

analyzeProduct('pokemon-scarlet-&-violet-151', 'charizard-ex-199');

import { search, getProduct, autocomplete } from '@deansasek/pricecharting-api';

const results = await search('charizard', { category: 'pokemon-cards' });

const suggestions = await autocomplete('char', 'pokemon-cards');

const categories = await getCategories();

const groups = await getGroupList('pokemon-cards');

const product = await getProductPrice('pokemon-scarlet-&-violet-151', 'charizard-ex-199');

const product = await getProductByUrl('https://www.pricecharting.com/game/pokemon-scarlet-&-violet-151/charizard-ex-199');

const meta = await getProductMeta('pokemon-scarlet-&-violet-151', 'charizard-ex-199');

npm run dev    # Development with tsx
npm run build && npm start  # Production

# Search for Charizard cards
curl "http://localhost:3000/search?q=charizard&category=pokemon-cards"

# Get product pricing
curl "http://localhost:3000/products/pokemon-scarlet-%26-violet-151/charizard-ex-199"

# Get autocomplete suggestions
curl "http://localhost:3000/autocomplete?q=char&category=pokemon-cards"

# List Pokemon sets/groups
curl "http://localhost:3000/groups/pokemon-cards"

// Success
{
  "success": true,
  "timestamp": "2026-08-07T00:00:00.000Z",
  // ... additional data
}

// Error
{
  "success": false,
  "timestamp": "2026-08-07T00:00:00.000Z",
  "error": "Error message"
}

{
  "mcpServers": {
    "pricecharting-api-mcp": {
      "command": "node",
      "args": ["dist/mcp/server.js"],
      "cwd": "/path/to/pricecharting"
    }
  }
}

User: Search for Charizard cards on PriceCharting
Claude uses: pricecharting_search with query="charizard", category="pokemon-cards"

User: Get pricing for Charizard ex from Scarlet & Violet 151
Claude uses: pricecharting_product_price with gameSlug="pokemon-scarlet-&-violet-151", productSlug="charizard-ex-199"

User: What categories are available on PriceCharting?
Claude uses: pricecharting_categories

User: Show me all Pokemon sets/groups
Claude uses: pricecharting_groups with category="pokemon-cards"

npm run build    # Compile TypeScript
npm run clean    # Remove dist folder
npm run dev      # Run server with tsx
npm start        # Run compiled server