Skip to content
MCP server

GitHubCard

Create GitHub profile and repository cards as SVG or PNG from your assistant

Install
Pricing
Freemium
Platforms
Web, API, CLI
Runs
Locally or Remotely
Version
0.2.1
Listing updated
3 days ago

About GitHubCard

GitHubCard is a freemium MCP server for developer tools. It can run locally on your machine or as a hosted remote server.

Asking for a card in plain words, such as a dark card for a repository to use as a link preview, produces image links plus Markdown and HTML embed snippets, using live GitHub data. A card combines widgets like stats, contribution heatmaps, commit streaks, top languages and star history on one canvas rather than a stack of separate README embeds.

Templates, palettes and widget types can be listed without a key, so you can explore before signing up; creating a card needs a free API key from the dashboard and each create uses one unit of a daily quota. A dry-run tool checks ids, Pro features and custom designs without spending quota.

The hosted server needs nothing installed, and a local stdio version can also edit a README on disk when started with a file-write flag. Setup snippets cover Claude Code, VS Code, Windsurf, Codex CLI and Gemini CLI.

Install

Run in a terminal

claude mcp add --transport http mcp https://githubcard.com/mcp

Add to Settings → Connectors → Add custom connector

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://githubcard.com/mcp"
    }
  }
}

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

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

Configuration

  • GHCARD_API_KEYAPI key from https://githubcard.com/dashboard. Needed to create cards.

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

create_card
Creates or reuses a card and returns image links and embed snippets.
validate_card
Dry run of create_card that uses no quota.
list_templates
Lists layouts, filterable by scope, plan and widget type.
list_palettes
Lists background palettes.
list_components
Lists widget types a card can contain.

What it does

Cards from chat
Create profile or repo cards with live GitHub data.
Embed snippets
Returns SVG and PNG links plus Markdown and HTML.
Dry-run validation
validate_card checks a design without using quota.
Browsable templates
Layouts, palettes and widgets listable without a key.
README editing
The local server can update a README when file writes are enabled.
Hosted and local
Streamable HTTP endpoint or npx stdio server.

Good for

  • Refresh a profile README with a single card link
  • Make a link-preview card for a repository
  • Restyle a card with a custom background colour
  • Check a design uses only Free-plan features

Pricing

Freemium

Free to start with a free API key and daily quota; some features need Pro. Prices not published here.

Prices change. Check githubcard.com before you buy.

GitHubCard FAQ

Do I need an API key?

Only to create cards; listing templates, palettes and components works without one.

Is it free?

The site says it is free to start; some features need Pro.

Can it edit my README?

Yes, with the local stdio server and the allow-file-writes flag.

What output formats are offered?

SVG and PNG links, with Markdown and HTML embed snippets.

Is GitHubCard free?

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

How do I add GitHubCard to Claude Code?

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

What are the best alternatives to GitHubCard?

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

Alternatives to GitHubCard

  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. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  3. 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
  4. 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
  5. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  6. 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