GitHubCard

Working Security A

com.githubcard/mcpv0.2.0 Domain verified

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

Developer Tools

Watch Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://githubcard.com/mcp

Authorization (optional)

"Bearer " followed by an API key from https://githubcard.com/dashboard. Needed to create cards; templates, palettes and components work without it.

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

create_card

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.

subjectstring, required

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

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

templatestring

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

watermarkboolean

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

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (10)

create_card

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.

Argument	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)

Input schema (JSON)

{
  "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": {
      "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)"
    }
  }
}

delete_card

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

destructive

Argument	Type	Description
id*	string	card id from create_card or list_cards

Input schema (JSON)

{
  "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"
    }
  }
}

get_card_design

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

read-only

Argument	Type	Description
id*	string	card id from create_card or list_cards

Input schema (JSON)

{
  "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"
    }
  }
}

get_template_design

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.

read-only

Argument	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

Input schema (JSON)

{
  "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"
    }
  }
}

get_usage

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

list_cards

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

read-only

Argument	Type	Description
limit	integer	page size 1-100 (default 20)
cursor	string	nextCursor from a previous call

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "page size 1-100 (default 20)"
    },
    "cursor": {
      "type": "string",
      "description": "nextCursor from a previous call"
    }
  }
}

list_components

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

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

list_palettes

List background palette ids accepted by create_card.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

list_templates

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

read-only

Argument	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

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "scope": {
      "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"
    }
  }
}

validate_card

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.

read-only

Argument	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)

Input schema (JSON)

{
  "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": {
      "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)"
    }
  }
}

GitHubCard

Try it

create_card

GitHubCard

Try it

create_card

Install

Tools (10)

Security checkA100/100