# GitHubCard

> GitHubCard is a freemium MCP server for developer tools. Create GitHub profile and repository cards as SVG or PNG from your assistant. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** Web, API, CLI
- **Website:** https://githubcard.com
- **Repository:** https://github.com/ghcardhq/githubcard-mcp
- **MCP Registry name:** com.githubcard/mcp
- **Categories:** developer tools, design and media
- **Listing updated:** 2026-11-14

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

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

```sh
https://githubcard.com/mcp
```

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

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

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

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

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

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

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

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

## Tools

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

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

- [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/githubcard
