Asset Hub Mcp

by tcamp4

262 downloads

Not rated

GitHub

Developer Tools

About

Asset Hub MCP gives AI coding agents access to a curated catalog of game-ready assets. It lets Codex, Claude Code, Cursor, and other MCP clients search for sounds, sprites, UI packs, music, textures, and other free or commercially usable assets, then install selected files direct

Details

Author: tcamp4
Downloads: 262
Categories: Developer Tools

- Search assets by type, query, tags, license, format, and source.
- Search inside archives for exact files with ranking hints.
- Download and extract authorized asset packs into a project directory.
- Install exact files returned by file search.
- Search and install best matching files in one call.
- Generate attribution text and JSON metadata for selected assets.
- Browse catalog options and list supported license policies.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Asset Hub Mcp

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "asset hub mcp": {
            "asset-hub": {
                "command": "npx",
                "args": [
                    "-y",
                    "@tcamp404/assethub-mcp@latest"
                ],
                "env": {
                    "ASSET_HUB_API_KEY": "ah_your_key",
                    "ASSET_HUB_API_BASE_URL": "https://assethubmcp.com"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "asset hub mcp": {
            "asset-hub": {
                "command": "npx",
                "args": [
                    "-y",
                    "@tcamp404/assethub-mcp@latest"
                ],
                "env": {
                    "ASSET_HUB_API_KEY": "ah_your_key",
                    "ASSET_HUB_API_BASE_URL": "https://assethubmcp.com"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "asset hub mcp": {
            "asset-hub": {
                "command": "npx",
                "args": [
                    "-y",
                    "@tcamp404/assethub-mcp@latest"
                ],
                "env": {
                    "ASSET_HUB_API_KEY": "ah_your_key",
                    "ASSET_HUB_API_BASE_URL": "https://assethubmcp.com"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "asset hub mcp": {
            "asset-hub": {
                "command": "npx",
                "args": [
                    "-y",
                    "@tcamp404/assethub-mcp@latest"
                ],
                "env": {
                    "ASSET_HUB_API_KEY": "ah_your_key",
                    "ASSET_HUB_API_BASE_URL": "https://assethubmcp.com"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "asset hub mcp": {
            "asset-hub": {
                "command": "npx",
                "args": [
                    "-y",
                    "@tcamp404/assethub-mcp@latest"
                ],
                "env": {
                    "ASSET_HUB_API_KEY": "ah_your_key",
                    "ASSET_HUB_API_BASE_URL": "https://assethubmcp.com"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "asset hub mcp": {
            "asset-hub": {
                "command": "npx",
                "args": [
                    "-y",
                    "@tcamp404/assethub-mcp@latest"
                ],
                "env": {
                    "ASSET_HUB_API_KEY": "ah_your_key",
                    "ASSET_HUB_API_BASE_URL": "https://assethubmcp.com"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "asset hub mcp": {
            "asset-hub": {
                "command": "npx",
                "args": [
                    "-y",
                    "@tcamp404/assethub-mcp@latest"
                ],
                "env": {
                    "ASSET_HUB_API_KEY": "ah_your_key",
                    "ASSET_HUB_API_BASE_URL": "https://assethubmcp.com"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "asset hub mcp": {
            "asset-hub": {
                "command": "npx",
                "args": [
                    "-y",
                    "@tcamp404/assethub-mcp@latest"
                ],
                "env": {
                    "ASSET_HUB_API_KEY": "ah_your_key",
                    "ASSET_HUB_API_BASE_URL": "https://assethubmcp.com"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "asset hub mcp": {
            "asset-hub": {
                "command": "npx",
                "args": [
                    "-y",
                    "@tcamp404/assethub-mcp@latest"
                ],
                "env": {
                    "ASSET_HUB_API_KEY": "ah_your_key",
                    "ASSET_HUB_API_BASE_URL": "https://assethubmcp.com"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "asset hub mcp": {
            "asset-hub": {
                "command": "npx",
                "args": [
                    "-y",
                    "@tcamp404/assethub-mcp@latest"
                ],
                "env": {
                    "ASSET_HUB_API_KEY": "ah_your_key",
                    "ASSET_HUB_API_BASE_URL": "https://assethubmcp.com"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "asset hub mcp": {
            "asset-hub": {
                "command": "npx",
                "args": [
                    "-y",
                    "@tcamp404/assethub-mcp@latest"
                ],
                "env": {
                    "ASSET_HUB_API_KEY": "ah_your_key",
                    "ASSET_HUB_API_BASE_URL": "https://assethubmcp.com"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "asset hub mcp": {
            "asset-hub": {
                "command": "npx",
                "args": [
                    "-y",
                    "@tcamp404/assethub-mcp@latest"
                ],
                "env": {
                    "ASSET_HUB_API_KEY": "ah_your_key",
                    "ASSET_HUB_API_BASE_URL": "https://assethubmcp.com"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "asset hub mcp": {
            "asset-hub": {
                "command": "npx",
                "args": [
                    "-y",
                    "@tcamp404/assethub-mcp@latest"
                ],
                "env": {
                    "ASSET_HUB_API_KEY": "ah_your_key",
                    "ASSET_HUB_API_BASE_URL": "https://assethubmcp.com"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "asset hub mcp": {
            "asset-hub": {
                "command": "npx",
                "args": [
                    "-y",
                    "@tcamp404/assethub-mcp@latest"
                ],
                "env": {
                    "ASSET_HUB_API_KEY": "ah_your_key",
                    "ASSET_HUB_API_BASE_URL": "https://assethubmcp.com"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "asset hub mcp": {
            "asset-hub": {
                "command": "npx",
                "args": [
                    "-y",
                    "@tcamp404/assethub-mcp@latest"
                ],
                "env": {
                    "ASSET_HUB_API_KEY": "ah_your_key",
                    "ASSET_HUB_API_BASE_URL": "https://assethubmcp.com"
                }
            }
        }
    }
}

From the repository

Install with npx -y @tcamp404/assethub-mcp@latest ASSET_HUB_API_KEY=ah_your_customer_key. Configure the server in your MCP client’s JSON, setting ASSET_HUB_API_KEY and optionally ASSET_HUB_API_BASE_URL. Then invoke tools like search_assets, install_asset_files, or install_best_asset with appropriate arguments.

`search_assets`

Search Asset Hub's hosted, license-aware game asset catalog.

`search_asset_files`

Search inside hosted asset archives and rank individual files, especially short UI sounds.

`download_asset`

Download an authorized asset archive and optionally extract selected files into a project directory.

`install_asset_files`

Install exact files returned by search_asset_files into a project directory and write project metadata.

`install_best_asset`

Search for the best matching hosted asset files and install them in one call.

`get_attribution`

Generate attribution text and structured metadata for selected hosted asset ids.

`browse_catalog_options`

List available catalog categories, sources, use cases, and query ideas for the current Asset Hub plan.

`list_licenses`

Show license ids understood by the hosted catalog and automation safety policy.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "asset hub mcp": {
            "asset-hub": {
                "command": "npx",
                "args": [
                    "-y",
                    "@tcamp404/assethub-mcp@latest"
                ],
                "env": {
                    "ASSET_HUB_API_KEY": "ah_your_key",
                    "ASSET_HUB_API_BASE_URL": "https://assethubmcp.com"
                }
            }
        }
    }
}

McpServers

{
    "asset-hub": {
        "command": "npx",
        "args": [
            "-y",
            "@tcamp404/assethub-mcp@latest"
        ],
        "env": {
            "ASSET_HUB_API_KEY": "ah_your_key",
            "ASSET_HUB_API_BASE_URL": "https://assethubmcp.com"
        }
    }
}

AssetHub MCP

AssetHub MCP is the public MCP client for Asset Hub MCP. It lets Codex, Claude Code, Cursor, and other MCP clients search a hosted catalog of game assets, install exact files into a project, and write attribution metadata.

This repository intentionally contains only the installable MCP client. The hosted API, billing, account system, and paid catalog infrastructure are private service code.

Tools

- search_assets - Search by type, query, tags, license, format, source, and game-fit hints.
- search_asset_files - Search inside archives for exact files such as click_001.ogg, with ranking hints for game genre, mood, style, use case, and avoided concepts.
- download_asset - Download and extract an authorized asset pack into a target directory.
- install_asset_files - Install exact files returned by file search.
- install_best_asset - Search and install the best matching files in one call.
- get_attribution - Generate attribution text and JSON metadata for selected assets.
- browse_catalog_options - Show categories, sources, use cases, and example queries available to the current plan.
- list_licenses - Show supported license policies and safe defaults.

Install

npx -y @tcamp404/assethub-mcp@latest ASSET_HUB_API_KEY=ah_your_customer_key

ASSET_HUB_API_BASE_URL defaults to https://assethubmcp.com.

MCP Client Config

{
  "mcpServers": {
    "asset-hub": {
      "command": "npx",
      "args": ["-y", "@tcamp404/assethub-mcp@latest"],
      "env": {
        "ASSET_HUB_API_KEY": "ah_your_customer_key",
        "ASSET_HUB_API_BASE_URL": "https://assethubmcp.com"
      }
    }
  }
}

Example Agent Flow

{
  "tool": "install_best_asset",
  "arguments": {
    "type": "sound",
    "query": "short menu click UI blip",
    "gameGenre": "cozy farming",
    "mood": "soft friendly",
    "intendedUse": "menu confirm",
    "avoid": ["horror", "weapon", "loud"],
    "targetDir": "public/audio/ui",
    "projectRoot": "/path/to/game",
    "includeExtensions": [".wav", ".ogg"],
    "maxFiles": 3
  }
}

For exact file installs:

{
  "tool": "search_asset_files",
  "arguments": {
    "type": "sound",
    "query": "short menu click",
    "gameContext": "cozy farming game main menu",
    "intendedUse": "short menu confirm",
    "formats": [".ogg"],
    "limit": 3
  }
}

Then pass the returned asset.id and file.entryPath values to install_asset_files.

For better matches, agents should pass fit hints whenever the game context matters:

- gameContext: short description of the game, level, scene, or mechanic.
- gameGenre: examples include cozy farming, fantasy RPG, sci-fi shooter, puzzle, or racing.
- mood: examples include cute, tense, dark, friendly, retro, or futuristic.
- visualStyle: examples include pixel, low-poly, cartoon, monochrome, or hand-drawn.
- intendedUse: examples include background loop, menu confirm, NPC, enemy, inventory icon, or terrain tile.
- prefer and avoid: extra concepts to reward or penalize.

Hosted API Contract

The hosted API stays private, but the client talks to a small documented JSON contract:

- POST /v1/search
- POST /v1/files/search
- GET /v1/assets/:assetId
- GET /v1/catalog/options
- GET /v1/licenses

All hosted requests use:

Authorization: Bearer ah_your_customer_key

search_assets may return locked upgrade matches when the current plan is too small:

{
  "results": [],
  "lockedResults": [
    {
      "id": "kenney-music-jingles",
      "title": "Kenney Music Jingles",
      "accessible": false,
      "upgradeRequired": "indie",
      "minimumPlan": "indie"
    }
  ],
  "plan": "free"
}

search_asset_files may return lockedAssetResults for above-plan packs when no accessible file results are found.

Use browse_catalog_options when an agent needs to discover what the catalog can answer before searching. It returns plan-specific categories, source names, curated use cases, and example queries such as short menu click, cozy farming sprites, hex strategy tiles, and low poly furniture props.

Claude Code

claude mcp add --transport stdio asset-hub --scope user \
  --env ASSET_HUB_API_KEY=ah_your_customer_key \
  --env ASSET_HUB_API_BASE_URL=https://assethubmcp.com \
  -- npx -y @tcamp404/assethub-mcp@latest

Development

npm install
npm run build
npm test

License

MIT. Installed third-party assets keep their original licenses and source metadata.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

search_assets

search_asset_files

download_asset

install_asset_files

install_best_asset

get_attribution

browse_catalog_options

list_licenses

Claude Desktop / Cursor

McpServers

AssetHub MCP

Tools

Install

MCP Client Config

Example Agent Flow

Hosted API Contract

Claude Code

Development

License

Install

More like this

Sentry

Github

Git

GitLab

Context 7

Playwright

`search_assets`

`search_asset_files`

`download_asset`

`install_asset_files`

`install_best_asset`

`get_attribution`

`browse_catalog_options`

`list_licenses`