AI Agents / MCP

AI agent setup guide

FreightPulse exposes fuel prices, freight rates, port congestion, disruptions, and carrier lookups as MCP tools at mcp.freightpulsehq.com, separate from (and calling straight into) the REST API at https://freightpulsehq.com/api/v1.

1. Add the MCP server to your client

{
  "mcpServers": {
    "freightpulse": {
      "url": "https://mcp.freightpulsehq.com/mcp"
    }
  }
}

Works immediately with no key (100 requests/day guest tier, shared by IP). For a private quota, add ?apikey=YOUR_KEY to the URL, or an Authorization: Bearer YOUR_KEY header if your client supports custom headers.

2. Get a key (optional, but recommended)

• From the agent itself: call the register MCP tool - no human sign-up form, no credit card, returns a working key on the perpetual free tier (100 requests/month, 5/minute).
• As a human: visit https://freightpulsehq.com/agents/connect while logged in for a one-click config with your existing key, or create a free account and generate one from the dashboard.

3. Available tools

• get_fuel_prices
• get_freight_rates
• get_port_congestion
• get_disruptions
• search_carriers
• get_historical_data
• register
• account_status

Full parameter reference: mcp.freightpulsehq.com/llms-full.txt. REST API docs: https://freightpulsehq.com/docs. Machine-readable auth guide: /auth.md.