diff --git a/.github/social-preview.png b/.github/social-preview.png
new file mode 100644
index 00000000..6814f479
Binary files /dev/null and b/.github/social-preview.png differ
diff --git a/README.md b/README.md
index 220d8d00..296dcc93 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,14 @@
# libtmux-mcp
+
+
+
+
+
+
+
+
+
A [Model Context Protocol](https://modelcontextprotocol.io) server for [tmux](https://github.com/tmux/tmux), built on [libtmux](https://libtmux.git-pull.com).
[](https://pypi.org/project/libtmux-mcp/)
diff --git a/assets/README.md b/assets/README.md
new file mode 100644
index 00000000..923da62d
--- /dev/null
+++ b/assets/README.md
@@ -0,0 +1,9 @@
+# Logo assets
+
+The README uses the Python palette and MCP overlay from the libtmux asset kit.
+`logo.svg` is the vector mark; `logo.png` is the transparent 512px fallback.
+The repository social card at `../.github/social-preview.png` uses the cog.
+
+The geometry comes from the project owner’s libtmux and tmuxp SVGs. The palette
+uses [GitHub Linguist’s Python color](https://github.com/github-linguist/linguist/blob/538da05f034fa5c83bd81df128d144e208898da3/lib/linguist/languages.yml).
+The overlay uses the symbol from the [MCP logo](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/088176704a4e8f20e7f1d237de1de8484aa412fd/docs/logo/light.svg).
diff --git a/assets/logo.png b/assets/logo.png
new file mode 100644
index 00000000..4075f81b
Binary files /dev/null and b/assets/logo.png differ
diff --git a/assets/logo.svg b/assets/logo.svg
new file mode 100644
index 00000000..25bb97ed
--- /dev/null
+++ b/assets/logo.svg
@@ -0,0 +1,2 @@
+
+
diff --git a/pyproject.toml b/pyproject.toml
index b54ee574..639b1d48 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -33,6 +33,7 @@ packages = [
{ include = "*", from = "src" },
]
include = [
+ { path = "assets", format = "sdist" },
{ path = "CHANGES", format = "sdist" },
{ path = "tests", format = "sdist" },
{ path = "docs", format = "sdist" },