Fairmarkit MCP Server (Beta)

Overview

The Fairmarkit MCP Server provides a simple, consistent way to automate RFQ workflows using any MCP-compatible client. With no additional authentication steps and a clean set of standardized tools, you can quickly incorporate Fairmarkit procurement actions into your AI agents and integrations.

The Fairmarkit MCP Server allows any MCP-compatible client to interact with Fairmarkit’s RFQ APIs through a unified, standardized interface. It provides a lightweight way for AI agents, automation tools, and custom integrations to create and manage RFQs using structured MCP tools.

This guide explains how to connect an MCP client to Fairmarkit, what tools are available, and how to use them in your workflows.

1. How the Fairmarkit MCP Server Works

The MCP server acts as a bridge between your MCP-compatible client and Fairmarkit’s RFQ platform. Once connected, your client can:

• Create new RFQs

• Retrieve and update RFQs

• Fetch supplier quotations

• Access reference data such as business units and units of measure

• Perform server health checks

No additional authentication is required — you use the same Fairmarkit API key you already use for the REST API.

Transport is handled through Server-Sent Events (SSE), enabling real-time communication with your MCP client.

---

2. Connecting an MCP Client

To connect, add the following configuration to your client’s MCP settings:

{
  "mcpServers": {
    "fairmarkit-rfq": {
      "type": "sse",
      "url": "https://mcp-v0.fmdev.io/sse",
      "headers": {
        "Authorization": "Bearer YOUR-FAIRMARKIT-API-KEY"
      }
    }
  }
}

Authentication

The Fairmarkit MCP Server does not introduce additional authentication steps. Use your existing Fairmarkit API key in the Authorization header.

---

3. Available Tools

The server exposes tools grouped into three categories: RFQ Management, Lookup/Reference, and Utility.

3.1 RFQ Management Tools

list_rfqs

Returns a paginated list of RFQs.

• Parameters:

  • limit (default: 20)

  • offset (default: 0)

---

get_rfq

Retrieves full details for a specific RFQ.

• Parameters:

  • uuid (RFQ ID)

---

create_rfq

Creates a new RFQ using simplified parameters.

• Required fields:

  • title

  • closes_at

  • buyer

  • item_titles

  • item_quantities

• Optional fields:

  • business_unit

  • item_benchmark_prices

  • item_uoms

  • currency

  • urgency

  • payment_process

  • country

  • notes

Supports creating RFQs with one or multiple inline items.

---

update_rfq

Updates editable fields for an RFQ.

• Required fields:

  • uuid

  • title

  • closes_at

  • categories (up to 50)

---

list_quotations

Retrieves supplier quotations for an RFQ.

• Parameters:

  • uuid

  • limit (1–100, default: 20)

  • offset (default: 0)

---

3.2 Lookup / Reference Tools

list_business_units

Returns available business units. Use uuid for subsequent operations.

• Parameters:

  • limit (default: 20)

  • offset (default: 0)

---

list_shipping_types

Returns supported shipping types: courier, ocean_freight, ground

---

list_carriers

Returns supported carriers: ups, fedex, dhl, usps

---

list_uoms

Returns supported units of measure: each, box, case, kg, lb

---

3.3 Utility Tools

health_check

Verifies server readiness and configuration.