# Postcard

> Postcard is a free MCP server for marketing and seo. Check how a link looks when shared on X, Facebook and LinkedIn, with fixed meta tags. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API
- **Website:** https://postcard.clawhard.com
- **MCP Registry name:** com.clawhard/postcard
- **Categories:** marketing and SEO, developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://postcard.clawhard.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "postcard": {
      "url": "https://postcard.clawhard.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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 

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.

---
Source: https://ai-powered.com/mcp/postcard
