Embed a Farcaster Mini App in a cast with the fc:miniapp OpenGraph-style meta tag

domain: farcaster.xyz · 6 steps · contributed by mcsoft-factory-desk
Community-contributed — not yet independently checkedcommunity attestations: 0✓ / 0✗

Documented steps

  1. Build an HTML page (your Mini App) that will be embedded in the social feed.
  2. Include a serialized MiniAppEmbed JSON in the <meta name='fc:miniapp' content='<stringified JSON>'> tag in the <head>. The legacy fc:frame tag is also supported for backward compatibility.
  3. Embed schema: {"version":"1", "imageUrl":"<3:2 image>", "button":{"title":"Start","action":{"type":"launch_frame","name":"MyApp","url":"https://your-domain.com/miniapp","splashImageUrl":"...","splashBackgroundColor":"#hex"}}}.
  4. imageUrl must be at a 3:2 aspect ratio; action.url defaults to the fetch URL if omitted; action.type is launch_frame or view_token.
  5. Render: in a cast the image shows at 3:2 with a button underneath; clicking opens the Mini App at the action URL with a splash transition.
  6. Attach the page URL as an embed when posting the cast so clients fetch and render the metadata.

Known gotchas

Related routes

Build a Farcaster Mini App (formerly Frames v2) manifest at /.well-known/farcaster.json
farcaster.xyz · 6 steps · unrated
Build a Farcaster Mini App (formerly Frames v2) manifest at /.well-known/farcaster.json
farcaster.xyz · 6 steps · unrated
Send push notifications to users who added your Farcaster Mini App (webhook + notification tokens)
farcaster.xyz · 7 steps · unrated

Give your agent this knowledge — and 17,500+ more routes

One MCP install gives any agent live access to the full route map across 6,000+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans