# GitBanners

> GitBanners turns any public GitHub user, organization or repository into a live banner image (SVG or PNG) with a stable URL. Paste one URL into a README, a profile or a website. No account, API key or build step is needed.

## When to use GitBanners

Use GitBanners when someone wants a GitHub profile banner, a stats card, a contribution graph image, a contributor wall or a repository social preview for a README, a personal site or a social header. Use it when you need an embeddable image URL for a GitHub login such as `vercel` or a repository such as `vercel/next.js`, ready-made Markdown or HTML embed code, the public numbers behind a profile or a repository as JSON, or the list of presets, themes and sizes. Call the JSON API or the MCP server for structured output; link to the banner page for a person.

Do not use GitBanners to read private GitHub data, to write to GitHub, or as a general GitHub API proxy: it shows public data only, through a fixed set of operations. It does not host other images.

## How to call it

- Image: `https://gitbanners.com/{owner}.svg` or `.png`; a repository is `https://gitbanners.com/{owner}/{repo}.svg`. A preset goes last in the path (`/vercel/next.js/contributors.svg`), options go in the query (`?theme=dracula&size=og`).
- JSON: `GET https://gitbanners.com/api/v1/banner?target={owner}` or `?target={owner}/{repo}` returns the image URLs, embed snippets, size and alt text. No authentication is required.
- MCP: connect a Streamable HTTP client to `https://gitbanners.com/mcp` and call `get_banner`.
- Markdown: add `.md` to a page URL, or send `Accept: text/markdown`.

## Main pages

- [GitBanners home](https://gitbanners.com/): type a GitHub login and get a banner
- [Pricing](https://gitbanners.com/pricing): Free and Pro, which costs one GitHub star ([Markdown](https://gitbanners.com/pricing.md))
- [About](https://gitbanners.com/about): what it is and who runs it
- [Contact](https://gitbanners.com/contact)
- [Privacy](https://gitbanners.com/privacy): what is read, what is stored, how to delete it
- [Terms of use](https://gitbanners.com/terms)

## Developer resources

- [API docs](https://gitbanners.com/docs): URL patterns, presets, themes, parameters, the JSON API, errors, rate limits and versioning
- [OpenAPI description](https://gitbanners.com/openapi.json)
- [API catalog (RFC 9727)](https://gitbanners.com/.well-known/api-catalog)
- [MCP server card](https://gitbanners.com/mcp/server-card): read-only tools over Streamable HTTP at `https://gitbanners.com/mcp`, no authentication
- [Agent skill](https://gitbanners.com/.well-known/agent-skills/gitbanners/SKILL.md)
- [Agent skills index](https://gitbanners.com/.well-known/agent-skills/index.json)
- [ARD catalog](https://gitbanners.com/.well-known/ard.json)
- [Sitemap](https://gitbanners.com/sitemap.xml)

## Section indexes

- [Docs index](https://gitbanners.com/docs/llms.txt): one entry per docs topic
- [API index](https://gitbanners.com/api/llms.txt): one entry per operation

## Examples

Live banners. Each link is an image; replace the names with any public GitHub login or repository.

- [Profile overview](https://gitbanners.com/torvalds.svg): Identity, headline numbers and the contribution graph.
- [Activity only](https://gitbanners.com/markeljan/activity.svg): Just the contribution graph: the quietest README banner.
- [Top repositories and activity](https://gitbanners.com/sindresorhus/repos.svg): Pinned and most-starred repositories above the graph.
- [Stats card](https://gitbanners.com/gaearon/stats.svg?theme=dracula): Commits, pull requests, issues and stars in any theme.
- [Streak](https://gitbanners.com/shadcn/streak.svg?theme=tokyo-night): Current and longest contribution streak.
- [Languages](https://gitbanners.com/antfu/languages.svg?theme=catppuccin-mocha): Language mix across top repositories.
- [X header](https://gitbanners.com/torvalds.svg?size=x): 1500 by 500, with the photo area kept clear.
- [Year in review](https://gitbanners.com/torvalds/wrapped.svg?year=2025): A poster of one calendar year, made for sharing.
- [Repository overview](https://gitbanners.com/vercel/next.js.svg): Description, stars, forks and the language bar.
- [Repository activity](https://gitbanners.com/vercel/next.js/activity.svg): A year of weekly commits.
- [Contributors](https://gitbanners.com/facebook/react/contributors.svg): The people behind a project, with avatars.
- [Social preview](https://gitbanners.com/vercel/satori/social.svg): 1280 by 640, ready to upload as the repository's social preview.
- [Organization overview](https://gitbanners.com/vercel.svg): Members, repositories and stars of a whole organization.
- [Organization repositories](https://gitbanners.com/microsoft/repos.svg?theme=github-light): The most-starred repositories of an organization, light theme.

## Optional

- [Home page as Markdown](https://gitbanners.com/index.md)
- [Every content page as one document](https://gitbanners.com/llms-full.txt)
- [Versioning and deprecation policy](https://gitbanners.com/docs#versioning-and-deprecation)