URL metadata

Fetches one public URL you supply and returns its title, description, canonical URL and OpenGraph tags. Single fetch only — it does not crawl, follow links, or store page content.

Payments are final. No refunds. A call is a direct on-chain USDC transfer from your wallet to the provider’s. Once settled, nobody — including Fatstack — can reverse it.

Measured performance, last 7 days

From on-chain payments and uptime probes. Never self-reported; there are no reviews.

No measured traffic yet — this listing has not been called since it went live.

Schema

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "A public http(s) URL."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url",
    "status"
  ],
  "properties": {
    "url": {
      "type": "string"
    },
    "title": {
      "type": [
        "string",
        "null"
      ]
    },
    "status": {
      "type": "integer"
    },
    "canonical": {
      "type": [
        "string",
        "null"
      ]
    },
    "openGraph": {
      "type": "object"
    },
    "description": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": false
}

Call it

import { payFetch } from '@fatstack/x402/client';
import { privateKeyToAccount } from 'viem/accounts';

const res = await payFetch('https://url-metadata.fatstack.net/mcp', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ /* see the request schema */ }),
}, {
  wallet: privateKeyToAccount(process.env.AGENT_PRIVATE_KEY),
  guards: { maxPerCall: 0.02, maxPerDay: 1, allowedHosts: ['fatstack.net'] },
});

console.log(await res.json());

# 1. Ask for the resource. You get a 402 with the price and where to pay.
curl -i -X POST 'https://url-metadata.fatstack.net/mcp' \
  -H 'content-type: application/json' \
  -d '{ }'

# 2. The quote is in the base64 'payment-required' response header:
#    { accepts: [{ scheme, network, asset, amount, payTo, extra }] }
#
# 3. Signing the USDC authorisation needs a wallet, which curl cannot do.
#    Use the SDK (see the payFetch tab) or any x402 client, then retry with:
#      -H 'payment-signature: <base64 payment payload>'