GitHubCard is an MCP server published by com.githubcard, hosted at githubcard.com. When last checked on 2026-11-22 it was up, but it asks for a sign-in before listing tools. It declares 10 tools, including create_card, validate_card, list_templates, list_palettes, list_components.
Create GitHub profile and repository cards for READMEs, link previews and social posts.
1 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
| Parameter | Type | Description |
|---|---|---|
| design | object | a design document from get_template_design or get_card_design, possibly edited; replaces template and palette |
| format | string | which link to return as url: "svg" (default; best for README embeds) or "png". Both are always in urls |
| palette | string | 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) |
| template |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| string |
| template id from list_templates; omit for the subject's default layout |
| watermark | boolean | false removes the watermark (Pro only; ignored on Free) |
{
"name": "create_card",
"title": "Create GitHub card",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"subject"
],
"properties": {
"design": {
"type": "object",
"description": "a design document from get_template_design or get_card_design, possibly edited; replaces template and palette",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"format": {
"enum": [
"svg",
"png"
],
"type": "string",
"description": "which link to return as url: \"svg\" (default; best for README embeds) or \"png\". Both are always in urls"
},
"palette": {
"type": "string",
"description": "background palette id from list_palettes; omit for the template's own background. For any other colour use design"
},
"subject": {
"type": "string",
"description": "GitHub username (e.g. octocat) or owner/repo (e.g. octocat/hello-world)"
},
"template": {
"type": "string",
"description": "template id from list_templates; omit for the subject's default layout"
},
"watermark": {
"type": "boolean",
"description": "false removes the watermark (Pro only; ignored on Free)"
}
}
},
"annotations": {
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| design | object | a design document from get_template_design or get_card_design, possibly edited; replaces template and palette |
| format | string | which link to return as url: "svg" (default; best for README embeds) or "png". Both are always in urls |
| palette | string | 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) |
| template | string | template id from list_templates; omit for the subject's default layout |
| watermark | boolean | false removes the watermark (Pro only; ignored on Free) |
{
"name": "validate_card",
"title": "Check a card request",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"subject"
],
"properties": {
"design": {
"type": "object",
"description": "a design document from get_template_design or get_card_design, possibly edited; replaces template and palette",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"format": {
"enum": [
"svg",
"png"
],
"type": "string",
"description": "which link to return as url: \"svg\" (default; best for README embeds) or \"png\". Both are always in urls"
},
"palette": {
"type": "string",
"description": "background palette id from list_palettes; omit for the template's own background. For any other colour use design"
},
"subject": {
"type": "string",
"description": "GitHub username (e.g. octocat) or owner/repo (e.g. octocat/hello-world)"
},
"template": {
"type": "string",
"description": "template id from list_templates; omit for the subject's default layout"
},
"watermark": {
"type": "boolean",
"description": "false removes the watermark (Pro only; ignored on Free)"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}List card layouts with their ids, scope (profile/repo/all), size, widget types, and whether they need Pro.
| Parameter | Type | Description |
|---|---|---|
| scope | string | profile or repo; omit for all. Results include scope=all templates, which fit both |
| widgets | array | only templates containing all of these widget types (from list_components) |
| freeOnly | boolean | only templates available on the Free plan |
{
"name": "list_templates",
"title": "List card templates",
"description": "List card layouts with their ids, scope (profile/repo/all), size, widget types, and whether they need Pro.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"scope": {
"enum": [
"profile",
"repo"
],
"type": "string",
"description": "profile or repo; omit for all. Results include scope=all templates, which fit both"
},
"widgets": {
"type": "array",
"items": {
"type": "string"
},
"description": "only templates containing all of these widget types (from list_components)"
},
"freeOnly": {
"type": "boolean",
"description": "only templates available on the Free plan"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}List background palette ids accepted by create_card.
No parameters.
{
"name": "list_palettes",
"title": "List background palettes",
"description": "List background palette ids accepted by create_card.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}List the widget (layer) types a design can contain: the scope (profile/repo) each fits, the layer settings each reads ("options", e.g. a text layer's style.textAlign or style.backgroundColor), and the font families the renderer embeds ("fonts").
No parameters.
{
"name": "list_components",
"title": "List widget types",
"description": "List the widget (layer) types a design can contain: the scope (profile/repo) each fits, the layer settings each reads (\"options\", e.g. a text layer's style.textAlign or style.backgroundColor), and the font families the renderer embeds (\"fonts\").",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| palette | string | palette id to apply; replaces the template's background in the returned design |
| subject | string | username or owner/repo the card is for; decides profile vs repo layouts |
| template * | string | template id from list_templates |
{
"name": "get_template_design",
"title": "Get a template's design",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"template"
],
"properties": {
"palette": {
"type": "string",
"description": "palette id to apply; replaces the template's background in the returned design"
},
"subject": {
"type": "string",
"description": "username or owner/repo the card is for; decides profile vs repo layouts"
},
"template": {
"type": "string",
"description": "template id from list_templates"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}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).
| Parameter | Type | Description |
|---|---|---|
| id * | string | card id from create_card or list_cards |
{
"name": "get_card_design",
"title": "Get a card's design",
"description": "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).",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "card id from create_card or list_cards"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}List cards this account created through the API, most recently requested first. Paginated with nextCursor.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | page size 1-100 (default 20) |
| cursor | string | nextCursor from a previous call |
{
"name": "list_cards",
"title": "List my cards",
"description": "List cards this account created through the API, most recently requested first. Paginated with nextCursor.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "page size 1-100 (default 20)"
},
"cursor": {
"type": "string",
"description": "nextCursor from a previous call"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}Permanently delete one of the account's cards. Its links stop working everywhere they are embedded. Confirm with the user first.
| Parameter | Type | Description |
|---|---|---|
| id * | string | card id from create_card or list_cards |
{
"name": "delete_card",
"title": "Delete a card",
"description": "Permanently delete one of the account's cards. Its links stop working everywhere they are embedded. Confirm with the user first.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "card id from create_card or list_cards"
}
}
},
"annotations": {
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}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.
{
"name": "get_usage",
"title": "Get plan and quota",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}GitHubCard turns a GitHub user or repository into an embeddable card image. Typical flow: 1. Optionally call list_templates (scope "profile" or "repo") and list_palettes to pick ids. 2. Call create_card with the subject. It returns SVG/PNG links and Markdown/HTML embed snippets. It is idempotent: the same parameters return the same card and link. 3. To place it in a README, insert embed.markdown into the file yourself. Share urls (live, re-render with current data); snapshotUrls are frozen images. Custom layouts (any hex background, size, font, or adding/removing/moving widgets): call get_template_design (free, no quota) or get_card_design to get a design document, edit it, check it with validate_card (free), then pass it as create_card's "design" instead of template/palette. Design document shape: artboard: {width, height (px, 100-4000), background: {color: a full CSS background, e.g. "#1e3a5f" or "radial-gradient(...) 0 0 / 22px 22px #0d1117"; a plain hex replaces any texture, so change only the trailing colour to keep it}, style: {fontFamily, textColor, secondaryTextColor, accentColor, radius}} layers: [{id (unique), type (from list_components), x, y, width, height (px from the artboard's top-left), layer (stacking order), style, ...widget settings}] Layers are absolutely positioned: removing one leaves its space empty, and anything outside the artboard is clipped, so move or resize neighbours yourself (validate_card warns about clipped layers). Keep version and any other fields you do not change; dataSource, ownerId, meta and showWatermark are replaced by the server. Widgets scale to their box. Text colours come from artboard.style (textColor, secondaryTextColor, accentColor) or a layer's style; when you change the background a lot, set them too so text stays readable. list_components gives each widget's settings and the usable fonts: a "text" layer takes "text" (" " breaks lines) and style fontSize/fontWeight/textColor/textAlign/backgroundColor/borderColor/borderWidth, which is enough for headlines, labels, and filled boxes or pills. Chinese, Japanese and Korean text renders through Noto Sans SC. For Star History (repo cards) add a repoStarsHistory layer with only position, size and style (style.starHistoryPreset: hand-drawn, editorial, or poster); the server fills the star data. Its numbers are a snapshot taken when the card is created. Plain solid colours are free; gradients and patterns are free only when they are a free preset, a list_palettes palette, or a free template's own background. On Free, the editor's Pro fonts and background presets fail with PRO_FEATURE (details.features lists each path); fonts and backgrounds that free templates already use are fine. Failed create_card calls are refunded. A first card can take a while to render: on CARD_GENERATION_IN_PROGRESS or NETWORK_ERROR wait ~30s and repeat the identical call. Each create_card call counts against a daily quota (get_usage shows what is left). Do not call create_card in a loop to "refresh" a card: the link always shows live data. Free accounts always get a small watermark.
Names, descriptions and schemas were written by the server and are shown as data.