GitHubCard

ghcardhq/githubcard-mcp

Create GitHub profile and repository cards for READMEs, link previews and social posts.

GitHub stars: 15
tools: 10
auth: Secret needed
transport: STDIO, HTTP
env var: 1
last updated: Nov 1, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://githubcard.com/mcp --name githubcard --header 'Authorization: Bearer ${API_TOKEN}'

Run in your terminal. add-mcp asks which agents to add it to, then asks for each value it needs. Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http githubcard https://githubcard.com/mcp --header 'Authorization: YOUR_AUTHORIZATION'

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 10 tools

Verified live against the running server on Nov 6, 2026.

create_cardCreate (or reuse) a published card image for a GitHub profile or repository. Returns svg/png URLs and markdown/html embed snippets. Idempotent; counts once against the daily quota.6 params

Create (or reuse) a published card image for a GitHub profile or repository. Returns svg/png URLs and markdown/html embed snippets. Idempotent; counts once against the daily quota.

Parameters* required

designobject

a design document from get_template_design or get_card_design, possibly edited; replaces template and palette

formatstring

which link to return as url: "svg" (default; best for README embeds) or "png". Both are always in urls

palettestring

background palette id from list_palettes; omit for the template's own background. For any other colour use design

subject*string

GitHub username (e.g. octocat) or owner/repo (e.g. octocat/hello-world)

templatestring

template id from list_templates; omit for the subject's default layout

watermarkboolean

false removes the watermark (Pro only; ignored on Free)

validate_cardDry run of create_card with the same inputs: checks template/palette ids, Pro features and the design document, without creating anything or using quota. warnings lists layers that reach outside the artboard (they would be clipped); fix those before create_card.6 params

Dry run of create_card with the same inputs: checks template/palette ids, Pro features and the design document, without creating anything or using quota. warnings lists layers that reach outside the artboard (they would be clipped); fix those before create_card.

Parameters* required

designobject

a design document from get_template_design or get_card_design, possibly edited; replaces template and palette

formatstring

which link to return as url: "svg" (default; best for README embeds) or "png". Both are always in urls

palettestring

background palette id from list_palettes; omit for the template's own background. For any other colour use design

subject*string

GitHub username (e.g. octocat) or owner/repo (e.g. octocat/hello-world)

templatestring

template id from list_templates; omit for the subject's default layout

watermarkboolean

false removes the watermark (Pro only; ignored on Free)

list_templatesList card layouts with their ids, scope (profile/repo/all), size, widget types, and whether they need Pro.3 params

List card layouts with their ids, scope (profile/repo/all), size, widget types, and whether they need Pro.

Parameters* required

freeOnlyboolean

only templates available on the Free plan

scopestring

profile or repo; omit for all. Results include scope=all templates, which fit both

widgetsarray

only templates containing all of these widget types (from list_components)

list_palettesList background palette ids accepted by create_card.

List background palette ids accepted by create_card.

No parameters. Call it with no arguments.

list_componentsList the widget (layer) types a design can contain, with the scope (profile/repo) each fits.

List the widget (layer) types a design can contain, with the scope (profile/repo) each fits.

No parameters. Call it with no arguments.

get_template_designReturn a template's layout as an editable design document (artboard + layers). Costs no quota. Edit it and pass it to create_card as design.3 params

Return a template's layout as an editable design document (artboard + layers). Costs no quota. Edit it and pass it to create_card as design.

Parameters* required

palettestring

palette id to apply; replaces the template's background in the returned design

subjectstring

username or owner/repo the card is for; decides profile vs repo layouts

template*string

template id from list_templates

get_card_designReturn the design document of one of the account's cards, to edit and re-submit through create_card as design (which creates a new card; the original is unchanged).1 params

Return the design document of one of the account's cards, to edit and re-submit through create_card as design (which creates a new card; the original is unchanged).

Parameters* required

id*string

card id from create_card or list_cards

list_cardsList cards this account created through the API, most recently requested first. Paginated with nextCursor.2 params

List cards this account created through the API, most recently requested first. Paginated with nextCursor.

Parameters* required

cursorstring

nextCursor from a previous call

limitinteger

page size 1-100 (default 20)

delete_cardPermanently delete one of the account's cards. Its links stop working everywhere they are embedded. Confirm with the user first.1 params

Permanently delete one of the account's cards. Its links stop working everywhere they are embedded. Confirm with the user first.

Parameters* required

id*string

card id from create_card or list_cards

get_usageShow the account's plan (free/pro) and how many cards it can still create today (cards.remaining, resets 00:00 UTC). The ai quota is reserved for future AI tools.

Show the account's plan (free/pro) and how many cards it can still create today (cards.remaining, resets 00:00 UTC). The ai quota is reserved for future AI tools.

No parameters. Call it with no arguments.

Configuration

GHCARD_API_KEYsecret

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

Readme

GitHubCard MCP server

Let your AI assistant create GitHubCard images: profile and repository cards for READMEs, link previews and social posts, with live GitHub data.

Hosted: https://githubcard.com/mcp (Streamable HTTP). Nothing to install.
Local: npx -y @ghcardhq/ghcard mcp (stdio), from the ghcard CLI. It can also edit a README on your disk.

Ask things like:

Make a GitHubCard for my profile and add it near the top of my README.

Create a dark card for vercel/next.js I can use as a link preview.

Use the compact repo template, but with a #1e3a5f background and without the language widget.

Get an API key

View the full README on GitHub

Details

Repository: github.com/ghcardhq/githubcard-mcp
Website: githubcard.com
Categories: Developer Tools, Media & Entertainment
Package: @ghcardhq/ghcard
Transport: STDIO, HTTP
Auth: Required
Registry: MCP registry, active
Tools verified: Nov 6, 2026

Related Developer Tools MCP servers

View all

Noospherejinning6/noosphereCommunity of Consciousness MCP Server — upload and explore collective wisdom via GitHub.15stars

Agent Memoryxchucx/agent-memoryGit-native project memory for AI coding agents: Markdown source of truth, reviewable, secret-safe.15stars

Longhandwynelson94/longhandLocal memory for Claude Code: 13 MCP tools for semantic recall, file replay, and git history.14stars

Memorydetectivecarloshpdoc/memorydetectiveiOS leak/perf debugging via MCP: memgraph cycles, .trace analysis, SourceKit-LSP bridging.11stars

Godot Forgegregario/godot-forgeGodot 4 MCP server — test runner, API docs, script analysis, scene parsing, LSP.7stars

Tiger Skillstimescale/tiger-skills-mcp-serverProvider agnostic skills implementation, with skills sourced from local paths or GitHub repositories7stars