Skip to main content
Glama
oganvil-mcp
by rowb53

oganvil-mcp

A minimal Model Context Protocol server for the oganvil OG image API — generate 1200×630 social preview images from a title and tag line, straight from your AI editor or agent.

Zero dependencies. Node 18+. Speaks MCP over stdio, so it works with Claude Desktop, Claude Code, Cursor, Windsurf, or any MCP-capable client.

Tools

Tool

Arguments

Returns

generate_og_image

title (required), tag, format (png|svg)

The 1200×630 image (PNG/SVG) plus a hosted render URL

get_quota

—

Current usage for the configured key (no quota consumed)

Identical renders (same title + tag + format) are served from cache and never billed twice.

Related MCP server: ogstamp

Install & run

# no install needed — run straight from source
node src/index.js

Claude Desktop / Claude Code / Cursor / Windsurf

Add to your MCP client config (claude_desktop_config.json, .cursor/mcp.json, …):

{
  "mcpServers": {
    "oganvil": {
      "command": "node",
      "args": ["/absolute/path/to/oganvil-mcp/src/index.js"],
      "env": {
        "OGANVIL_API_KEY": "oganvil-demo-key"
      }
    }
  }
}

oganvil-demo-key is a public free key: 10 renders/day per IP, no signup. For the permanent free tier (50 unique images/month, no card) grab a key at https://oganvil.rowu.workers.dev/signup.

Configuration

Env var

Default

Meaning

OGANVIL_API_KEY

oganvil-demo-key

Your API key (free key from /signup, or a paid key)

OGANVIL_API_URL

https://oganvil.rowu.workers.dev

API base URL

Example session

→ initialize
← {"serverInfo":{"name":"oganvil-mcp","version":"0.1.0"}}

→ tools/call generate_og_image {"title":"Ship faster","tag":"oganvil","format":"png"}
← image/png 1200x630 (28 KB) + hosted URL https://oganvil.rowu.workers.dev/api/render?title=Ship+faster&tag=oganvil

Verified output from this repo's source: PNG signature 89504e47, dimensions 1200 x 630, ~28 KB.

Also available over HTTP

If your client speaks remote MCP (Streamable HTTP), you don't need this package at all — the hosted server is at:

POST https://oganvil.rowu.workers.dev/mcp
Authorization: Bearer oganvil-demo-key

Two tools there: generate_og_image, get_quota.

REST API

GET https://oganvil.rowu.workers.dev/api/render?title=Hello&tag=World&format=png

Free tier: 50 unique images/month, no credit card. Paid: $5/mo (500 images) and $29/mo (5,000 images).

License

MIT

Available Tools

2 tools
generate_og_imageA

Generate a 1200x630 Open Graph (social preview) image from a title and optional tag line. Returns the hosted image URL and PNG/SVG bytes. Repeat identical renders are cached and not billed twice.

Inputs: title (required), tag, format.

get_quotaA

Show the current monthly unique-image usage for the configured oganvil API key (no quota consumed).

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have clearly distinct purposes: one generates an OG image, the other reports quota usage. There is no overlap or plausible confusion between generating an image and checking monthly usage.

    Naming Consistency5/5

    Both tool names use a consistent snake_case verb_noun pattern: generate_og_image and get_quota. The convention is predictable and readable.

    Tool Count4/5

    Two tools is slightly below the typical 3-15 range, but it fits this server's narrow scope of image generation plus quota inspection. Each tool earns its place, though the set feels minimal.

    Completeness4/5

    The core lifecycle is covered: generating an image and checking quota consumption. Minor gaps exist, such as managing or listing previously generated cached images, but they are not essential for the stated purpose.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables coding agents to render 1200×630 Open Graph social card images from a title, subtitle, and theme, returning a public PNG URL. It also provides pricing information for purchasing one-time forever credits.
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables any MCP-capable agent to generate App Store and Google Play store screenshots from screen layout JSON plus local image file paths, returning a job ID for async polling or a direct download link. It also exposes render status polling with signed download URLs and per-response quota, balance, and cost metadata.
      2
      187 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      An MCP server and an agent skill for imagor, a fast, secure image processing server. An agent writes a layout (OG cards, product grids, quotes, testimonials) and it compiles to one imagor URL, served from your own instance.
      10
      4
      MIT