@prompthub/mcp

MCP server for PromptHub. Publish, fetch, list, update and search prompt repositories from Claude Code or Codex.

1. Get a token

Sign in at https://www.awesome-prompt.com → Settings → API tokens → create a token. Copy the ph_… value (shown once).

2. Configure

Either set an environment variable:

export PROMPTHUB_TOKEN=ph_xxx
# optional, defaults to https://www.awesome-prompt.com
export PROMPTHUB_BASE_URL=https://www.awesome-prompt.com

…or create ~/.prompthub/config.json:

{ "token": "ph_xxx", "baseUrl": "https://www.awesome-prompt.com" }

Environment variables take precedence over the file.

3. Register the server

Claude Code:

claude mcp add prompthub --env PROMPTHUB_TOKEN=ph_xxx -- npx -y @prompthub/mcp

Codex — add to ~/.codex/config.toml:

[mcp_servers.prompthub]
command = "npx"
args = ["-y", "@prompthub/mcp"]
env = { PROMPTHUB_TOKEN = "ph_xxx" }

4. Tools

5. First run

Confirm it's wired up — ask your assistant:

"Use prompthub_whoami to check my PromptHub login."

You should see your handle. Then publish:

"Publish the prompt we just wrote to PromptHub as a private repo called my-first-prompt."

The assistant will call prompthub_publish_session and reply with the new repo URL (e.g. https://www.awesome-prompt.com/@you/my-first-prompt). If it's unsure of the format, it can call prompthub_describe_file_format first.

License

MIT