`x402_seller_health`

Pack: factline-x402-health · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/x402_seller_health for the schema, then POST the same URL with its arguments for the data.

Rank/search x402 sellers with a health reading from Factline’s nightly probes (does a sample endpoint still answer a valid x402 payment challenge). Covers ~1,000 sellers from public x402 catalogues but each call returns at most 100, ranked by 30-day unique payers: use “query”, “tag” or “network” to reach the rest. An empty result (count:0) means the filter matched nothing among the tracked sellers; it is NOT evidence that anything is healthy. To check one specific seller use x402_seller_lookup. Returns source, data_as_of, origins_tracked and warnings.

Parameters

Name	Type	Required	Description
`query`	string	no	Free text matched against seller name/host/tags (e.g. “sanctions”, “exa”)
`tag`	string	no	Seller tag filter (e.g. “search”, “llm”)
`network`	string	no	Network filter (e.g. “base”, “solana”)
`limit`	number	no	Max sellers to return, 1-100 (default 25)

Example call

Arguments

{
  "query": "exa",
  "limit": 5
}

curl

curl -X POST https://gateway.pipeworx.io/factline-x402-health/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"x402_seller_health","arguments":{"query":"exa","limit":5}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('x402_seller_health', {
  "query": "exa",
  "limit": 5
});

Response shape

Field	Type	Description
`source`	string
`cite_as`	string
`cadence`	string
`data_as_of`	string
`origins_tracked`	number
`count`	number
`limit`	number
`warnings`	array
`coverage_note`	string
`sellers`	array

Full JSON Schema

{
  "type": "object",
  "properties": {
    "source": {
      "type": "string"
    },
    "cite_as": {
      "type": "string"
    },
    "cadence": {
      "type": "string"
    },
    "data_as_of": {
      "type": "string"
    },
    "origins_tracked": {
      "type": "number"
    },
    "count": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    },
    "warnings": {
      "type": "array",
      "items": {}
    },
    "coverage_note": {
      "type": "string"
    },
    "sellers": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "origin": {
            "type": "string"
          },
          "host": {
            "type": "string"
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "health": {
            "type": "string"
          },
          "health_basis": {
            "type": "string"
          },
          "uptime": {
            "type": "object",
            "properties": {
              "valid_402_rate": {
                "type": "number"
              },
              "avg_ms": {
                "type": "number"
              },
              "probe_days": {
                "type": "number"
              }
            },
            "additionalProperties": true
          },
          "listings": {
            "type": "number"
          },
          "payers_30d": {
            "type": "number"
          },
          "real_payers_30d": {
            "type": "null"
          },
          "calls_30d": {
            "type": "number"
          },
          "catalogues": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "networks": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "tags": {
            "type": "array",
            "items": {
              "type": [
                "string",
                null
              ]
            }
          },
          "cheapest_usd": {
            "type": "number"
          },
          "listed_wallets": {
            "type": "number"
          }
        },
        "additionalProperties": true
      }
    }
  },
  "additionalProperties": true
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the factline-x402-health pack

{
  "mcpServers": {
    "factline-x402-health": {
      "url": "https://gateway.pipeworx.io/factline-x402-health/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

x402_seller_health