`get_metadata`

Pack: microlink · Endpoint: https://gateway.pipeworx.io/microlink/mcp

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

Extract metadata from any URL to preview page content. Returns title, description, image, author, publisher, logo, and structured data—useful when you need to understand a webpage without visiting it directly.

Parameters

Name	Type	Required	Description
`url`	string	yes	The URL to extract metadata from.

Example call

Arguments

{
  "url": "https://www.example.com"
}

curl

curl -X POST https://gateway.pipeworx.io/microlink/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_metadata","arguments":{"url":"https://www.example.com"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('get_metadata', {
  "url": "https://www.example.com"
});

More examples

{
  "url": "https://github.com/microlinkhq/sdk"
}

Response shape

Field	Type	Description
`url`	string \| null	The URL of the webpage
`title`	string \| null	Page title
`description`	string \| null	Page description or meta description
`author`	string \| null	Author of the page content
`publisher`	string \| null	Publisher of the page
`date`	string \| null	Publication or modification date
`lang`	string \| null	Language of the page
`image`	object \| null	Primary image metadata
`logo`	object \| null	Logo metadata

Full JSON Schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": [
        "string",
        "null"
      ],
      "description": "The URL of the webpage"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "Page title"
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "Page description or meta description"
    },
    "author": {
      "type": [
        "string",
        "null"
      ],
      "description": "Author of the page content"
    },
    "publisher": {
      "type": [
        "string",
        "null"
      ],
      "description": "Publisher of the page"
    },
    "date": {
      "type": [
        "string",
        "null"
      ],
      "description": "Publication or modification date"
    },
    "lang": {
      "type": [
        "string",
        "null"
      ],
      "description": "Language of the page"
    },
    "image": {
      "type": [
        "object",
        "null"
      ],
      "description": "Primary image metadata",
      "properties": {
        "url": {
          "type": "string",
          "description": "Image URL"
        },
        "width": {
          "type": [
            "number",
            "null"
          ],
          "description": "Image width in pixels"
        },
        "height": {
          "type": [
            "number",
            "null"
          ],
          "description": "Image height in pixels"
        }
      }
    },
    "logo": {
      "type": [
        "object",
        "null"
      ],
      "description": "Logo metadata",
      "properties": {
        "url": {
          "type": "string",
          "description": "Logo URL"
        },
        "width": {
          "type": [
            "number",
            "null"
          ],
          "description": "Logo width in pixels"
        },
        "height": {
          "type": [
            "number",
            "null"
          ],
          "description": "Logo height in pixels"
        }
      }
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

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

See Getting Started for client-specific install steps.

get_metadata