{
  "markdown": "# Heropedia Plugin for Claude Code\n\nConsult 324+ hand-crafted expert personas — Warren Buffett, Steve Jobs, Charlie Munger, Linus Torvalds, and more — directly from any Claude Code session.\n\nThis plugin bundles:\n\n- **`heropedia` skill** — triggers on phrases like *\"ask <name> to...\"*, *\"consult <name>\"*, *\"channel <name>\"*. Fetches the canonical persona prompt from Heropedia MCP before answering, so the reply is truly through that expert's lens (not an impression of it).\n- **`.mcp.json`** — registers `https://www.heropedia.org/mcp` as an MCP server so Claude Code can call `getList`, `getListByHero`, `getListByRole`, and `getDetail`.\n\nThe plugin does not ship any data. All 324+ personas live at [heropedia.org](https://www.heropedia.org) and are fetched on demand.\n\n## Install\n\nPick your AI. Every path targets the same endpoint (`https://www.heropedia.org/mcp`).\n\n### Anthropic — Claude Code (recommended)\n\n```bash\nclaude plugin marketplace add https://github.com/SiliconRoshiBill/heropedia-plugin\nclaude plugin install heropedia@heropedia\n```\n\nAuto-registers the MCP server as `plugin:heropedia:heropedia`. Open a new session and you're wired up.\n\n### Anthropic — Claude Desktop\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"heropedia\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"https://www.heropedia.org/mcp\"]\n    }\n  }\n}\n```\n\n### OpenAI — ChatGPT (web / macOS / Windows apps)\n\nAvailable on **Plus, Pro, Business, Enterprise, and Edu plans** (not Free / Team).\n\n1. Settings → *Connectors* → Advanced → toggle *Developer mode* on.\n2. Settings → *Connectors* → *Add custom connector*.\n3. Paste MCP URL: `https://www.heropedia.org/mcp`\n4. Auth: *No authentication*. Save.\n5. Enable the *Heropedia* connector for chats where you want it.\n\nBusiness/Enterprise workspaces: a workspace admin adds the connector under Workspace Settings → Connectors → New app.\n\n### OpenAI — Codex (CLI)\n\n```bash\ncurl -sSL https://raw.githubusercontent.com/SiliconRoshiBill/heropedia-plugin/main/codex/install-codex.sh | bash\n```\n\nAdd `--with-agents` to also install the workflow-enforcing `AGENTS.md`:\n\n```bash\ncurl -sSL https://raw.githubusercontent.com/SiliconRoshiBill/heropedia-plugin/main/codex/install-codex.sh | bash -s -- --with-agents\n```\n\nOr manually add to `~/.codex/config.toml`:\n\n```toml\n[mcp_servers.heropedia]\nurl = \"https://www.heropedia.org/mcp\"\n```\n\n### OpenAI — Agents SDK\n\n**Python** (`openai-agents-python`):\n\n```python\nfrom agents import Agent, Runner\nfrom agents.mcp import MCPServerStreamableHttp\n\nasync with MCPServerStreamableHttp(\n    params={\"url\": \"https://www.heropedia.org/mcp\"},\n    name=\"heropedia\",\n) as server:\n    agent = Agent(\n        name=\"ConsultantAgent\",\n        instructions=(\n            \"When the user asks to consult a specific expert, call \"\n            \"getListByHero to find the entry, then getDetail to fetch \"\n            \"the canonical prompt. Apply that persona — do not paraphrase.\"\n        ),\n        mcp_servers=[server],\n    )\n    result = await Runner.run(agent, \"Ask Warren Buffett to review my pricing page.\")\n    print(result.final_output)\n```\n\n**TypeScript** (`@openai/agents`):\n\n```ts\nimport { Agent, Runner } from \"@openai/agents\";\nimport { MCPServerStreamableHttp } from \"@openai/agents/mcp\";\n\nconst heropedia = new MCPServerStreamableHttp({\n  url: \"https://www.heropedia.org/mcp\",\n  name: \"heropedia\",\n});\n\nconst agent = new Agent({\n  name: \"ConsultantAgent\",\n  instructions:\n    \"When the user asks to consult a specific expert, call getListByHero \" +\n    \"to find the entry, then getDetail to fetch the canonical prompt. \" +\n    \"Apply that persona — do not paraphrase.\",\n  mcpServers: [heropedia],\n});\n\nconst result = await Runner.run(agent, \"Ask Warren Buffett to review my pricing page.\");\nconsole.log(result.finalOutput);\n```\n\n### Google — Gemini CLI\n\nThis repo ships a [`gemini-extension.json`](./gemini-extension.json). Follow the [Gemini CLI extensions guide](https://geminicli.com/docs/extensions/) to add it, or paste this into your Gemini config:\n\n```json\n{\n  \"mcpServers\": {\n    \"heropedia\": {\n      \"httpUrl\": \"https://www.heropedia.org/mcp\"\n    }\n  }\n}\n```\n\n### Cursor\n\nAdd to your Cursor MCP config file:\n\n```json\n{\n  \"mcpServers\": {\n    \"heropedia\": {\n      \"url\": \"https://www.heropedia.org/mcp\"\n    }\n  }\n}\n```\n\n### Any HTTP MCP client\n\nDirect JSON-RPC 2.0 POST to `https://www.heropedia.org/mcp`. See [heropedia.org/mcp-guide](https://www.heropedia.org/mcp-guide) for examples.\n\n## Try it\n\nOnce installed, just ask:\n\n> \"Ask Warren Buffett to review my SaaS pricing page.\"\n> \"As Steve Jobs, tear apart this landing page.\"\n> \"Consult Charlie Munger on this go/no-go decision.\"\n> \"What would Linus Torvalds say about this refactor?\"\n> \"Get a product critic to look at this feature spec.\"\n\nClaude will:\n1. Recognize the persona intent.\n2. Call `mcp__heropedia__getListByHero` to find the entry.\n3. Call `mcp__heropedia__getDetail` to fetch the canonical prompt.\n4. Answer through that persona's lens.\n\nIf a name maps to multiple roles (e.g. Warren Buffett as investor vs. business analyst), Claude asks which lens fits your task before answering.\n\n## What's inside\n\n```\nheropedia-plugin/\n├── .claude-plugin/\n│   └── plugin.json          # plugin manifest\n├── .mcp.json                # MCP server registration\n├── skills/\n│   └── heropedia/\n│       └── SKILL.md         # workflow enforcement skill\n└── README.md\n```\n\n## Requirements\n\n- Claude Code (any recent version).\n- Internet access — the MCP server is hosted at `https://www.heropedia.org/mcp`.\n- Nothing else. No API key. No account. Public endpoint, IP-rate-limited (300 req/min list, 60 req/min detail).\n\n## The MCP endpoint\n\nPublic HTTP MCP server at `https://www.heropedia.org/mcp` speaking [MCP 2025-06-18 Streamable HTTP](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports). Four read-only tools:\n\n| Tool | Purpose |\n|---|---|\n| `getList` | Paginated catalog of every hero × role entry |\n| `getListByHero` | Filter by hero name (regex, case-insensitive, safe grammar) |\n| `getListByRole` | Filter by role name (same regex rules) |\n| `getDetail` | Full canonical markdown for one entry |\n\nReturns lightweight metadata (`{id, hero_name, role_name, description}`) from LIST tools; only `getDetail` returns the full persona prompt.\n\nUser guide with install snippets, examples, and FAQ: [heropedia.org/mcp-guide](https://www.heropedia.org/mcp-guide)\n\n## Uninstall\n\n```bash\nclaude plugin uninstall heropedia\n```\n\n## License\n\nMIT. See [`LICENSE`](./LICENSE).\n\nThe persona content at heropedia.org is separately MIT-licensed in the [`SiliconRoshiBill/heropedia`](https://github.com/SiliconRoshiBill/heropedia) content repo.\n\n## Contribute a new hero\n\nAnyone with a GitHub account can. Submit at [heropedia.org/submit](https://www.heropedia.org/submit). The community votes on the best versions.\n",
  "bytes": 6889,
  "sha": "505e298d35851c91df01bf7dce606e2c8b234a050a94ffea03982e97f405aab3",
  "repo_slug": "siliconroshibill/heropedia-plugin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_siliconroshibill_heropedia_cdf7c5d3/readme"
}