API Reference

MCP Integration

Connect VALUE AI to MCP-compatible clients through the hosted MCP endpoint.

Quick Start

  1. Create an API key in your dashboard.
  2. Add a client config entry that points to https://tryvalue.ai/mcp.
  3. Send your key in header x-value-api-key.
{
  "mcpServers": {
    "value-api": {
      "url": "https://tryvalue.ai/mcp",
      "headers": {
        "x-value-api-key": "value_your_api_key"
      }
    }
  }
}

OpenClaw

Add this server to your OpenClaw MCP config.

{
  mcp: {
    servers: {
      "value-api": {
        url: "https://tryvalue.ai/mcp",
        headers: {
          "x-value-api-key": "value_your_api_key"
        }
      }
    }
  }
}

Requests with missing or invalid x-value-api-key return 401.

Normalized Response

The appraise_product tool returns a normalized payload designed for agents.

{
  "tool": "appraise_product",
  "request": {
    "image_url": "https://images.example.com/product.jpg",
    "country": "us"
  },
  "normalized": {
    "ok": true,
    "status": 200,
    "estimated_value": {
      "lower": 1100,
      "upper": 1500,
      "midpoint": 1300,
      "currency": "USD"
    },
    "reasoning": [
      "Comparable sold listings cluster in a similar condition range."
    ],
    "best_match": {
      "title": "Comparable Listing",
      "url": "https://example.com/listing/123",
      "vendor": "Example Market",
      "image_url": "https://example.com/listing/123/image.jpg",
      "price": 1295
    },
    "comparables": [],
    "defects": [],
    "error": null
  }
}

Tools available: appraise_product, valuation_health.