Skip to content
MCP server

Postcard

Check how a link looks when shared on X, Facebook and LinkedIn, with fixed meta tags

Status and history

Answered our latest tool-list check 9 hours ago with 2 tools. It will be marked verified after 3 successful checks in 7 days.

Pricing
Free
Platforms
Web, API
Runs
Remotely
Version
1.0.0
Listing updated
3 days ago

About Postcard

Postcard is a free MCP server for marketing and seo. It runs as a hosted remote server, so there is nothing to install locally.

Postcard fetches a page the way a link crawler does, with no JavaScript and redirects followed, reads the twitter: tags before the og: tags, and then downloads the share image to measure its true pixel size, format and file size. It checks these against each platform's documented limits: X needs at least 300x157 at 2:1 and under 5 MB, Facebook 200x200 minimum with 600x315 for the large card, LinkedIn 1200x627.

Typical failures it catches include tags injected by React code, an image URL that returns app HTML, relative image paths, SVGs, and robots.txt rules blocking Twitterbot. The result ends with a corrected meta block using the image's real dimensions. Platforms cache cards (X for about seven days), so a rescrape with each platform's debugger is still needed after a fix.

Two tools exist: one for live pages and one for HTML that is not deployed yet. No account or key is needed, and a JSON API with an OpenAPI spec offers the same checks.

Install

Run in a terminal

claude mcp add --transport http postcard https://postcard.clawhard.com/mcp

Add to Settings → Connectors → Add custom connector

https://postcard.clawhard.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "postcard": {
      "url": "https://postcard.clawhard.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "postcard": {
      "type": "http",
      "url": "https://postcard.clawhard.com/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "postcard": {
      "serverUrl": "https://postcard.clawhard.com/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "postcard": {
      "type": "http",
      "url": "https://postcard.clawhard.com/mcp"
    }
  }
}

Tools this server provides (2)

Read directly from the server.

postcard_check_link_preview
Use when the user asks how a link will look when shared, why a shared link shows no image or the wrong title, or wants a page checked before a launch post (signals: "link preview", "og:image not showing", "Twitter card", "X card", "social card", "share image", "unfurl", "Open Graph", "LinkedIn preview is blank", "after deploying the landing page"). Fetches the public page the way a link crawler do
postcard_check_preview_tags
Use when the share-card tags need checking in HTML that is not public yet: a page being built, a localhost or staging page, a template, or a <head> block the user pasted (signals: "check my meta tags", "are these og tags right", "before I deploy", "Next.js metadata", "index.html head"). Reads the og: and twitter: tags in the pasted HTML with X's documented fallbacks and returns the same result as

What it does

Real image measurement
Reads actual dimensions, format and bytes from the downloaded image.
Crawler-style fetch
Sees only what link crawlers see, without running scripts.
Per-platform cards
Shows how X, Facebook, LinkedIn and chat apps build the card.
Fix-ready tags
Outputs a corrected meta block.
Pre-deploy check
Validates pasted HTML before it is live.

Good for

  • Find out why a link shows no image on X
  • Verify meta tags after a deploy
  • Let a coding agent fix and recheck share tags
  • Check an SVG or relative image path problem

Pricing

Free

Free, no account

Prices change. Check postcard.clawhard.com before you buy.

Postcard FAQ

Does it need an account?

No account, key or login.

Why does my old card still appear?

Platforms cache cards, X for about 7 days; rescrape with each platform's debugger or use a new URL.

What image size is safe?

The site recommends 1200x630 as PNG or JPG well under 5 MB.

Can it check unpublished HTML?

Yes, with the postcard_check_preview_tags tool.

Is Postcard free?

Yes. Postcard is free to use.

How do I add Postcard to Claude Code?

Run this command in your terminal: claude mcp add --transport http postcard https://postcard.clawhard.com/mcp

What are the best alternatives to Postcard?

The closest alternatives to Postcard are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Postcard

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools