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
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 toolsVerified 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
designobjecta design document from get_template_design or get_card_design, possibly edited; replaces template and palette
formatstringwhich link to return as url: "svg" (default; best for README embeds) or "png". Both are always in urls
palettestringbackground palette id from list_palettes; omit for the template's own background. For any other colour use design
subject*stringGitHub username (e.g. octocat) or owner/repo (e.g. octocat/hello-world)
templatestringtemplate id from list_templates; omit for the subject's default layout
watermarkbooleanfalse 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
designobjecta design document from get_template_design or get_card_design, possibly edited; replaces template and palette
formatstringwhich link to return as url: "svg" (default; best for README embeds) or "png". Both are always in urls
palettestringbackground palette id from list_palettes; omit for the template's own background. For any other colour use design
subject*stringGitHub username (e.g. octocat) or owner/repo (e.g. octocat/hello-world)
templatestringtemplate id from list_templates; omit for the subject's default layout
watermarkbooleanfalse 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
freeOnlybooleanonly templates available on the Free plan
scopestringprofile or repo; omit for all. Results include scope=all templates, which fit both
widgetsarrayonly 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
palettestringpalette id to apply; replaces the template's background in the returned design
subjectstringusername or owner/repo the card is for; decides profile vs repo layouts
template*stringtemplate 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*stringcard 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
cursorstringnextCursor from a previous call
limitintegerpage 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*stringcard 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.
Sponsors
Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageConfiguration
GHCARD_API_KEYsecretAPI 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 theghcardCLI. 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.jsI can use as a link preview.Use the compact repo template, but with a
#1e3a5fbackground and without the language widget.
Get an API key
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
