LTL Rate Expert (RateVault MCP Server)

MCP server for RateVault.ai -- LTL carrier rate sheet extraction and comparison.

This server provides tools to parse LTL freight rate sheet PDFs, list carriers, retrieve carrier data, and compare accessorial fees across carriers through the Model Context Protocol.

What Can It Do?

• Upload a carrier PDF and get every fee extracted into structured data
• Compare liftgate fees across XPO, Estes, ODFL, Saia, and FedEx
• Find which carrier has the cheapest hazmat handling
• Summarize accessorial changes between rate sheet versions

Tools

| Tool | Description | | ---------------------- | -------------------------------------------------------------------------------------------------------------- | | parse_rate_sheet | Extract structured pricing data (accessorials, lane rates, fuel surcharges) from an LTL carrier rate sheet PDF | | list_carriers | List all available carriers with their extracted documents | | get_carrier | Get detailed extracted data for a specific carrier | | compare_accessorials | Compare a specific accessorial fee across all carriers |

Setup

Get an API Key

Sign up at ratevault.ai to get your API key.

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "ratevault": {
      "command": "npx",
      "args": ["-y", "ratevault-mcp"],
      "env": {
        "RATEVAULT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

Add to your Cursor MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "ratevault": {
      "command": "npx",
      "args": ["-y", "ratevault-mcp"],
      "env": {
        "RATEVAULT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

claude mcp add ratevault -- npx -y ratevault-mcp

Then set the environment variable:

export RATEVAULT_API_KEY="your-api-key-here"

Environment Variables

| Variable | Required | Description | | ------------------- | -------- | ------------------------------------------------------------------ | | RATEVAULT_API_KEY | Yes | Your RateVault API key | | RATEVAULT_API_URL | No | Override the API base URL (defaults to https://api.ratevault.ai) |

Example Prompts

Once connected, you can ask your AI assistant things like:

• "Which carrier in my folder has the cheapest hazmat fee for this lane?"
• "Summarize the accessorial changes in the new FedEx 2026 sheet versus 2025."
• "Parse this XPO rate sheet and show me any fees over $200"
• "Compare residential delivery charges across all carriers"

Development

git clone https://github.com/karlwaldman/ratevault-mcp.git
cd ratevault-mcp
npm install
npm run build
npm start

License

MIT