MCP Server Setup Guide

Connect the PricingSaaS Intelligence MCP server to Claude Desktop or any MCP-compatible client to access pricing data directly from your AI assistant.

What is MCP?

The Model Context Protocol (MCP) is an open standard that enables AI assistants to securely connect to external data sources and tools. The PricingSaaS MCP server provides AI assistants with direct access to our pricing intelligence database.

Features

7 Tools Available: Access company data and historical scrape files
Real-time Data: Query live pricing intelligence data
Secure Authentication: API key-based authentication
Cost Tracking: 1 credit per tool call (same as REST API)
No Installation: HTTP-based server, no local installation needed

Prerequisites

Claude Desktop (or another MCP-compatible client)
A PricingSaaS API key (get one from your dashboard)

Quick Setup for Claude Desktop

1. Locate Your Configuration File

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%\Claude\claude_desktop_config.json

Linux:

~/.config/Claude/claude_desktop_config.json

2. Edit Configuration File

Open the configuration file and add the PricingSaaS MCP server:

{
  "mcpServers": {
    "pricingsaas": {
      "type": "http",
      "url": "https://api.pricingsaas.com/functions/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

Replace YOUR_API_KEY_HERE with your actual API key (e.g., ps_N0GmTWnOZz3HglzZRqFiqLMsStysMFcZWhNsKKBNoSU)

3. Restart Claude Desktop

Quit Claude Desktop completely (⌘Q on Mac, or fully close on Windows/Linux)
Restart Claude Desktop
Look for the MCP indicator (🔌 icon) to confirm connection

4. Verify Connection

Ask Claude:

What MCP tools do you have access to?

You should see 7 PricingSaaS tools listed.

Multiple MCP Servers

If you already have other MCP servers configured, simply add the PricingSaaS server to the existing configuration:

{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": ["-y", "@supabase/mcp-server-supabase@latest"],
      "env": {
        "SUPABASE_ACCESS_TOKEN": "your_token"
      }
    },
    "pricingsaas": {
      "type": "http",
      "url": "https://api.pricingsaas.com/functions/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    },
    "other-server": {
      "type": "http",
      "url": "https://example.com/mcp"
    }
  }
}

Available Tools

Once connected, your AI assistant will have access to these tools:

Company Tools

Tool	Description	Cost
`list-companies`	List all companies with pagination	1 credit
`get-company`	Get company details by slug	1 credit
`search-companies`	Search companies by name	1 credit

Files Tools

Tool	Description	Cost
`get-files-by-version`	Get scrape files for a specific version (YYYYMMDD)	1 credit
`get-files-by-quarter`	Get scrape files for a quarter (e.g., 2025Q4)	1 credit
`get-files-by-month`	Get scrape files for a month (e.g., 2025M12)	1 credit
`get-files-by-week`	Get scrape files for an ISO week (e.g., 2025W42)	1 credit

Usage Examples

Example 1: List Companies

Ask Claude:

Show me the first 10 companies in the PricingSaaS database

Claude will use the list-companies tool with limit: 10.

Example 2: Get Company Details

Ask Claude:

Get detailed information about Stripe's pricing

Claude will use the get-company tool with slug: "stripe".

Example 3: Search Companies

Ask Claude:

Find all companies related to "project management"

Claude will use the search-companies tool.

Example 4: Get Historical Pricing Files

Ask Claude:

Get all pricing page files for Stripe from Q4 2024

Claude will use the get-files-by-quarter tool with slug: "stripe" and quarter: "2024Q4".

Example 5: Compare Pricing Changes

Ask Claude:

Compare Stripe's pricing from January 2024 and January 2025

Claude will use get-files-by-version twice and compare the results.

Authentication & API Keys

Getting an API Key

Sign up at PricingSaaS Dashboard
Navigate to API Keys
Create a new API key
Copy the key (starts with ps_...)

API Key Format

ps_N0GmTWnOZz3HglzZRqFiqLMsStysMFcZWhNsKKBNoSU

Security Best Practices

Never commit API keys to version control
Use environment variables when possible
Rotate keys regularly for production use
Monitor usage in your dashboard

Troubleshooting

Connection Issues

Problem: Claude doesn’t show the PricingSaaS tools Solutions:

Verify the configuration file is valid JSON (use a JSON validator)
Check that Claude Desktop was fully restarted (not just minimized)
Look for error messages in Claude Desktop logs
Verify the API key is correct and active

Authentication Errors

Problem: “Unauthorized” or “Invalid API key” errors Solutions:

Double-check the API key is correct (including no extra spaces)
Verify the key hasn’t expired
Ensure the key has the correct permissions
Check your credit balance in the dashboard

Rate Limiting

Problem: “Insufficient credits” error Solutions:

Check your credit usage in the dashboard
Wait for credits to reset (monthly)
Upgrade your plan for more credits

Tool Not Found

Problem: Claude says it doesn’t have access to a specific tool Solutions:

Ask Claude to list all available tools
Restart Claude Desktop to refresh tool list
Verify the MCP server is properly configured

Advanced Configuration

Using Environment Variables

Instead of hardcoding the API key, you can use environment variables: macOS/Linux:

{
  "mcpServers": {
    "pricingsaas": {
      "type": "http",
      "url": "https://api.pricingsaas.com/functions/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${PRICINGSAAS_API_KEY}"
      }
    }
  }
}

Then set the environment variable:

export PRICINGSAAS_API_KEY="ps_YOUR_API_KEY"

Custom Headers

Add additional headers if needed:

{
  "mcpServers": {
    "pricingsaas": {
      "type": "http",
      "url": "https://api.pricingsaas.com/functions/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY",
        "X-Custom-Header": "value"
      }
    }
  }
}

Other MCP Clients

While this guide focuses on Claude Desktop, the PricingSaaS MCP server works with any MCP-compatible client:

Continue.dev

Add to your config.json:

{
  "mcpServers": {
    "pricingsaas": {
      "url": "https://api.pricingsaas.com/functions/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Custom MCP Client

Use the MCP SDK to connect:

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { HttpClientTransport } from '@modelcontextprotocol/sdk/client/http.js';

const transport = new HttpClientTransport({
  url: 'https://api.pricingsaas.com/functions/v1/mcp',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const client = new Client({
  name: 'my-app',
  version: '1.0.0'
}, {
  capabilities: {}
});

await client.connect(transport);

Cost & Credits

Free Tier: 1,000 credits/month
Cost per Tool Call: 1 credit
No Setup Fee: MCP server access is included
Same Pricing as REST API: MCP and REST API share the same credit pool

Monitor your usage in the PricingSaaS Dashboard.

MCP Server Metadata

The PricingSaaS MCP server implements the following specifications:

Protocol Version: MCP 2025-03-26
Transport: Streamable HTTP (JSON-RPC over HTTP)
Authentication: Bearer token (API key)
Discovery: /.well-known/oauth-authorization-server

Health Check

Verify the MCP server is running:

curl https://api.pricingsaas.com/functions/v1/mcp/health

Expected response:

{
  "status": "ok",
  "server": "pricingsaas-mcp",
  "version": "1.0.0",
  "capabilities": ["tools"],
  "tools": [
    "list-companies",
    "get-company",
    "search-companies",
    "get-files-by-version",
    "get-files-by-quarter",
    "get-files-by-month",
    "get-files-by-week"
  ]
}

Additional Resources

MCP Protocol Documentation: https://modelcontextprotocol.io
PricingSaaS API Docs: https://api.pricingsaas.com/functions/v1/api/docs
Files API Guide: FILES_API_GUIDE.md
Support: [email protected]
GitHub Issues: https://github.com/pricingsaas/pricingsaas-valut/issues

Example Configuration Templates

Minimal Configuration

{
  "mcpServers": {
    "pricingsaas": {
      "type": "http",
      "url": "https://api.pricingsaas.com/functions/v1/mcp",
      "headers": {
        "Authorization": "Bearer ps_YOUR_API_KEY"
      }
    }
  }
}

With Multiple Servers

{
  "mcpServers": {
    "pricingsaas": {
      "type": "http",
      "url": "https://api.pricingsaas.com/functions/v1/mcp",
      "headers": {
        "Authorization": "Bearer ps_YOUR_API_KEY"
      }
    },
    "supabase": {
      "command": "npx",
      "args": ["-y", "@supabase/mcp-server-supabase@latest", "--project-ref=YOUR_PROJECT"]
    }
  }
}

Production Configuration with Environment Variables

{
  "mcpServers": {
    "pricingsaas": {
      "type": "http",
      "url": "https://api.pricingsaas.com/functions/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${PRICINGSAAS_API_KEY}"
      }
    }
  }
}

Need Help?

Documentation Issues: Open an issue
API Questions: [email protected]
Feature Requests: GitHub Discussions

Get Started

Core Concepts

Guides

​MCP Server Setup Guide

​What is MCP?

​Features

​Prerequisites

​Quick Setup for Claude Desktop

​1. Locate Your Configuration File

​2. Edit Configuration File

​3. Restart Claude Desktop

​4. Verify Connection

​Multiple MCP Servers

​Available Tools

​Company Tools

​Files Tools

​Usage Examples

​Example 1: List Companies

​Example 2: Get Company Details

​Example 3: Search Companies

​Example 4: Get Historical Pricing Files

​Example 5: Compare Pricing Changes

​Authentication & API Keys

​Getting an API Key

​API Key Format

​Security Best Practices

​Troubleshooting

​Connection Issues

​Authentication Errors

​Rate Limiting

​Tool Not Found

​Advanced Configuration

​Using Environment Variables

​Custom Headers

​Other MCP Clients

​Continue.dev

​Custom MCP Client

​Cost & Credits

​MCP Server Metadata

​Health Check

​Additional Resources

​Example Configuration Templates

​Minimal Configuration

​With Multiple Servers

​Production Configuration with Environment Variables

​Need Help?

MCP Server Setup Guide

What is MCP?

Features

Prerequisites

Quick Setup for Claude Desktop

1. Locate Your Configuration File

2. Edit Configuration File

3. Restart Claude Desktop

4. Verify Connection

Multiple MCP Servers

Available Tools

Company Tools

Files Tools

Usage Examples

Example 1: List Companies

Example 2: Get Company Details

Example 3: Search Companies

Example 4: Get Historical Pricing Files

Example 5: Compare Pricing Changes

Authentication & API Keys

Getting an API Key

API Key Format

Security Best Practices

Troubleshooting

Connection Issues

Authentication Errors

Rate Limiting

Tool Not Found

Advanced Configuration

Using Environment Variables

Custom Headers

Other MCP Clients

Continue.dev

Custom MCP Client

Cost & Credits

MCP Server Metadata

Health Check

Additional Resources

Example Configuration Templates

Minimal Configuration

With Multiple Servers

Production Configuration with Environment Variables

Need Help?