# postcache

> postcache is a freemium MCP server for design and media. Temporary public media URLs, checked and fixed for Instagram, Threads and Facebook. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API
- **Website:** https://postcache.dev/docs
- **MCP Registry name:** dev.postcache/postcache
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-16

## About

Meta's publishing APIs want a public URL for each image or video, which an agent often does not have. postcache fills that gap: upload a file (up to 1 GiB over the REST API, 10 MB base64 over MCP) or give a public source URL, name the target such as instagram.reels or threads, and get back a link that expires after a set time, from 1 hour to 7 days.

It checks each file against the target's rules and can fix what is fixable: images become sRGB JPEG with crop or white padding, videos become H.264/AAC MP4 with crop or black bars. Duration is never trimmed, so too-short or too-long clips are refused with a 422. A dry run checks without storing anything and is free.

Plans are Free (100 uploads a month), Builder (2,000) and Studio (20,000), or an agent can pay per upload at $0.01 in USDC via x402 or MPP, or buy 500 uploads for $5.

## Features

- **Target-aware checks:** Validates against rules for instagram feed, reels, story, carousel, threads and facebook.page.
- **Automatic conversion:** convert=crop or pad fixes format, ratio, codec and size where possible.
- **Expiring URLs:** Links last 1 hour to 7 days and can be deleted at once.
- **Dry run:** Checks a file for free without storing it.
- **Agent payments:** Pay per upload in USDC with no account via x402 or MPP.
- **Public-only fetching:** Source URLs must be public; private addresses are refused after redirects.

## Good for

- Hand an Instagram Reel to Meta's API as a public URL
- Convert a mismatched image into an allowed aspect ratio
- Test whether a video passes Threads rules before posting
- Delete the media after a post publishes

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http postcache https://postcache.dev/mcp
```

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

```sh
https://postcache.dev/mcp
```

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

```json
{
  "mcpServers": {
    "postcache": {
      "url": "https://postcache.dev/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "postcache": {
      "type": "http",
      "url": "https://postcache.dev/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "postcache": {
      "serverUrl": "https://postcache.dev/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "postcache": {
      "type": "http",
      "url": "https://postcache.dev/mcp"
    }
  }
}
```

## Tools

- `upload_media`: Upload by source_url or data_base64 for a target
- `check_media`: Validate a file without storing it
- `get_media`: Read status and URL by id
- `delete_media`: Delete stored media by id

## FAQ

### What does it cost?

Free covers 100 uploads a month; Builder 2,000 and Studio 20,000; paid agents pay $0.01 per upload.

### How long do URLs last?

Between 3,600 and 604,800 seconds, default 24 hours.

### Will it trim long videos?

No. Duration problems are rejected, never trimmed.

### Do I need an account?

Not for pay-per-use; otherwise sign up for a key.

### Is postcache free?

postcache has a free plan, with paid plans for more usage or features.

### How do I add postcache to Claude Code?

Run this command in your terminal: claude mcp add --transport http postcache https://postcache.dev/mcp

### What are the best alternatives to postcache?

The closest alternatives to postcache are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [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.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

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