# bestagentthemes.com

A directory of themes for Claude: animated backdrops for the Claude desktop app and color themes for Claude Code in the terminal. Independent, not affiliated with Anthropic.

## Data
- https://bestagentthemes.com/data/themes.json : the main list (backdrops, terminal themes and Omarchy's picture backgrounds) with an install prompt for each (a prompt to paste into Claude Code, which then does the install), licenses, sources and colors.
- https://bestagentthemes.com/data/community.json : themes other people published on GitHub, with author, license, source link and an install prompt.

## Guides for agents
- https://bestagentthemes.com/guides/backdrops.md : how a backdrop is installed, and how to build one from a scene or picture.
- https://bestagentthemes.com/guides/terminal-themes.md : how a terminal color theme is installed and what its file holds.
- https://bestagentthemes.com/source/theme-examples/index.md : the source of Anthropic's theme-examples plugin, copied whole.

## Looking for something to feature this week?
- https://bestagentthemes.com/weekly.md : this week's pack as a ready newsletter section: one desktop backdrop, one terminal theme and three community themes, each with a blurb, credit, license and link.
- https://bestagentthemes.com/weekly.json : the same pack as data. Fixed weeks live at https://bestagentthemes.com/weekly/<year>-W<week>.json and .md, for example https://bestagentthemes.com/weekly/2026-W46.md.
- https://bestagentthemes.com/feed.xml : RSS, one entry per week.
You may feature these in a newsletter or a post. Credit the author named on each item and link to the item's url. The picks rotate through the directory by week; they are not a ranking.

## MCP server
https://bestagentthemes.com/mcp (MCP over HTTP, one JSON-RPC message per POST, header Authorization: Bearer <key>).
Tools: submit_theme, list_my_submissions, withdraw_submission.
Install in Claude Code: claude mcp add --transport http agentthemes https://bestagentthemes.com/mcp --header "Authorization: Bearer <key>"

## Submitting a theme as an agent
You need an API key. You cannot create an account or a key yourself: the person you work for signs in at https://bestagentthemes.com/submit/ with their email, makes a key at https://bestagentthemes.com/account/ and gives it to you.

POST https://bestagentthemes.com/api/v1/themes
Headers: Authorization: Bearer <key>, Content-Type: application/json
Body fields:
- name (required): The theme's name, 2 to 80 characters.
- kind (required): One of terminal, backdrop or other.
- url (required): Public https address of the theme on github.com, gist.github.com, gitlab.com or codeberg.org.
- author (required): The name or handle to credit, up to 60 characters.
- rights (required): Must be true: the work is the submitter's own, or its license allows sharing.
- link (optional): An https address the credit should link to.
- notes (optional): Up to 600 characters for the reviewer.
- company_domain (optional): Set only for a theme made on behalf of a company, for example acme.com. The account's email must be on that domain.

Success: 201 {"id": number, "status": "pending", "message": string}. A person reviews every submission; nothing is published automatically.
List the account's submissions: GET https://bestagentthemes.com/api/v1/themes with the same Authorization header.
Errors are JSON {"error": code, "message": text}: 400 bad field, 401 unauthorized, 403 company_domain_mismatch, 409 duplicate, 429 rate_limited (10 per account per 24 hours).
Rules: submit only work the account owner made or may share; one request per theme; set company_domain only when the account's email is on that company's domain.