MCP Protocol

Beta

Model Context Protocol for AI inventory access

Connect Claude, Cursor, or any MCP-compatible AI assistant directly to your Techfleet Sync inventory. Your AI can query stock, check pricing, and place orders in real time — no manual data export required.

What is MCP?

The Model Context Protocol (MCP) is an open standard developed by Anthropic that allows AI assistants to connect to external data sources and tools. When you add Techfleet Sync as an MCP server, your AI assistant can query your inventory with the same fluency it reads documents — and act on what it finds.

Quick connect

Claude Desktop

Add the following to your Claude Desktop config at ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "techfleet-sync": {
      "type": "sse",
      "url": "https://sync.techfleet.dev/api/mcp/sse?slug=YOUR_BUYER_SLUG"
    }
  }
}

Replace YOUR_BUYER_SLUG with your buyer link slug from the Techfleet Sync dashboard (Settings → Buyer Links).

⌥

Cursor

In Cursor, go to Settings → MCP → Add Server and enter:

Name:     Techfleet Sync
Command:  npx -y @techfleet/mcp-server
Env:
  TECHFLEET_API_KEY=sk_live_your_api_key_here
  TECHFLEET_MERCHANT_ID=your_merchant_id

HTTP MCP Server (direct)

For clients that support HTTP MCP servers, connect directly to:

https://sync.techfleet.dev/mcp/{YOUR_MERCHANT_ID}
Authorization: Bearer sk_live_your_api_key_here

Available tools

The Techfleet MCP server exposes the following tools to AI agents.

Device Catalog

New

5,300+ devices across 13 categories — smartphones, tablets, laptops, smartwatches, audio, gaming consoles, VR headsets, and more. Normalized numeric specs, model numbers, GTIN/UPC barcodes, and resale pricing.

search_catalog(query, make?, category?, sort_by?, limit?)

Search the global device catalog by name, model number, or keyword. Returns normalized specs (battery_mah, ram_gb, display_size_in, etc.), match confidence scoring, and data quality metrics. Supports filtering by make, category, and sorting by spec fields.

get_device_specs(slug | name)

Get full device specifications by slug or name. Returns normalized numeric specs, model numbers, GTIN/UPC barcode, resale market pricing, and a data_quality_score (0-100). Use this to verify device identity before placing an order.

compare_devices(slugs[] (2-4 device slugs))

Side-by-side comparison of 2-4 devices. Returns normalized specs for each device plus a diff object highlighting where specifications differ. Ideal for evaluating trade-in alternatives or recommending upgrades.

Inventory & Orders

list_inventory(model?, grade?, min_battery?, max_price?, available?)

Return paginated, filterable list of inventory units. Supports filtering by model, grade, battery health, price range, and availability.

get_product(inventory_id | imei)

Get full details for a single unit by inventory ID or IMEI, including condition notes, repair history, and functional test results.

check_availability(inventory_ids[])

Confirm real-time availability for one or more units. Returns availability status and any pending reservations.

get_pricing(inventory_ids[], buyer_id?)

Return buyer-specific pricing for one or more units, with applicable margin rules and tier discounts applied.

create_order(inventory_ids[], buyer_id, notes?)

Place an order for specified units. Requires write-scoped API key. Units are reserved for 15 minutes pending confirmation.

Example: querying inventory with Claude

BUYER (via Claude)

Show me all iPhone 14 Pro units, Grade A or better, unlocked, under $600. I need at least 10 units.

CLAUDE + TECHFLEET MCP

Using list_inventory with model=iPhone 14 Pro, grade=A+,A, carrier_locked=false, max_price=60000... Found 23 units matching your criteria. Here's a summary: • 8 units — iPhone 14 Pro 128GB, Grade A+, avg. $549 • 11 units — iPhone 14 Pro 256GB, Grade A, avg. $571 • 4 units — iPhone 14 Pro 512GB, Grade A, avg. $589 All 23 are available for immediate shipment from the Toronto warehouse. Would you like me to reserve 10 specific units and create an order?

BUYER (via Claude)

Yes, reserve the 10 cheapest units.

CLAUDE + TECHFLEET MCP

Creating order with the 10 lowest-priced available units... Order ord_01h9xmk created. 10 units reserved for 15 minutes. Total: $5,490 USD. I'll need you to confirm to finalize the order.

Authentication and scopes

MCP connections authenticate with your Techfleet API key. We recommend creating a dedicated API key for each MCP client (Claude, Cursor, etc.) so you can revoke them independently.

read

Allows list_inventory, get_product, check_availability, get_pricing. Cannot place orders.

read+write

Includes all read operations plus create_order. Required if you want AI agents to place orders on your behalf.

Supported MCP clients

Claude Desktop

Claude.ai (Pro)

Cursor

Continue.dev

Cline

Zed AI

Any MCP-compatible client

Ready to connect your AI assistant?

MCP support is available on Pro and Enterprise plans. Generate your API key from the dashboard.

Start Free Trial See UCP Protocol