{"_id":"@btafoya/flarum-mcp-server","_rev":"4-9e59a27b1a4057f0c5742f52f624be2b","name":"@btafoya/flarum-mcp-server","dist-tags":{"latest":"1.1.0"},"versions":{"1.0.0":{"name":"@btafoya/flarum-mcp-server","version":"1.0.0","keywords":["mcp","flarum","forum","claude","anthropic","model-context-protocol"],"author":{"name":"Brian Tafoya","email":"btafoya@briantafoya.com"},"license":"MIT","_id":"@btafoya/flarum-mcp-server@1.0.0","maintainers":[{"name":"btafoya","email":"btafoya@briantafoya.com"}],"homepage":"https://github.com/btafoya/flarum-mcp-server#readme","bugs":{"url":"https://github.com/btafoya/flarum-mcp-server/issues"},"bin":{"flarum-mcp-server":"build/index.js"},"dist":{"shasum":"041975daebbb939b3cd30bdaf093219253991189","tarball":"https://registry.npmjs.org/@btafoya/flarum-mcp-server/-/flarum-mcp-server-1.0.0.tgz","fileCount":30,"integrity":"sha512-pEpNHkB7HkIv7ePHN5yJGqM8WJa4faXIIPa+dWC0OZQ4BxeELfPeQduRSAP1EYLiqV6UM8qyT7k2E9Tjui2FPg==","signatures":[{"sig":"MEUCIDXjP2n3+hlTJb0OoST0EJRiIbB3e0KLNJgAeUgwZy5jAiEA0Y4+tm51yQP8ZU4i/0cv+NCIdr9KNO1m5TUnZ/7bT14=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":153073},"main":"build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"9d0ab5f8cb1d5df262dbd35edf38be5d7cde573d","scripts":{"dev":"tsc --watch","test":"npm run build && node --test test/**/*.test.js","build":"tsc","start":"node build/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"btafoya","email":"btafoya@briantafoya.com"},"repository":{"url":"git+https://github.com/btafoya/flarum-mcp-server.git","type":"git"},"_npmVersion":"11.16.0","description":"MCP server for Flarum forum - CRUD operations for discussions, posts, users, and tags","directories":{},"_nodeVersion":"24.14.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/flarum-mcp-server_1.0.0_1782002150940_0.5501316378778525","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@btafoya/flarum-mcp-server","version":"1.0.1","keywords":["mcp","flarum","forum","claude","anthropic","model-context-protocol"],"author":{"name":"Brian Tafoya","email":"btafoya@briantafoya.com"},"license":"MIT","_id":"@btafoya/flarum-mcp-server@1.0.1","maintainers":[{"name":"btafoya","email":"btafoya@briantafoya.com"}],"homepage":"https://github.com/btafoya/flarum-mcp-server#readme","bugs":{"url":"https://github.com/btafoya/flarum-mcp-server/issues"},"bin":{"flarum-mcp-server":"build/index.js"},"dist":{"shasum":"50f11758946fc228b72f0f8a6f182808331ba7f9","tarball":"https://registry.npmjs.org/@btafoya/flarum-mcp-server/-/flarum-mcp-server-1.0.1.tgz","fileCount":30,"integrity":"sha512-7KNmp7PgFa2h468baxtrQ/PCTGEg3GGE4F+h08gBKW0jktpGEJGGKGvwWOy8qiL0sXzw7K+5zX17SFoB0SCDxg==","signatures":[{"sig":"MEUCIQCrxKScdELmTXtpjVeLUpyo4NgU9BNDZ5Uz3qPXz8Kx5QIgI4MlzGrrgJYnaU87suIe/wWCT/woPReiA1qWfQycuws=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":154194},"main":"build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"265dffd08e1468fe08e4ad0a9e505ac093717fb3","scripts":{"dev":"tsc --watch","test":"npm run build && node --test test/**/*.test.js","build":"tsc","start":"node build/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"btafoya","email":"btafoya@briantafoya.com"},"repository":{"url":"git+https://github.com/btafoya/flarum-mcp-server.git","type":"git"},"_npmVersion":"11.16.0","description":"MCP server for Flarum forum - CRUD operations for discussions, posts, users, and tags","directories":{},"_nodeVersion":"24.14.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/flarum-mcp-server_1.0.1_1782004497296_0.73851783410174","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@btafoya/flarum-mcp-server","version":"1.0.2","keywords":["mcp","flarum","forum","claude","anthropic","model-context-protocol"],"author":{"name":"Brian Tafoya","email":"btafoya@briantafoya.com"},"license":"MIT","_id":"@btafoya/flarum-mcp-server@1.0.2","maintainers":[{"name":"btafoya","email":"btafoya@briantafoya.com"}],"homepage":"https://github.com/btafoya/flarum-mcp-server#readme","bugs":{"url":"https://github.com/btafoya/flarum-mcp-server/issues"},"bin":{"flarum-mcp-server":"build/index.js"},"dist":{"shasum":"a56889318e9f478c9bced8527d64d790d5a04191","tarball":"https://registry.npmjs.org/@btafoya/flarum-mcp-server/-/flarum-mcp-server-1.0.2.tgz","fileCount":30,"integrity":"sha512-mqbbB1FopYmZwY+UtbJA5G4x7VMNEpnADf/4IizcmgPbDI+DRNJegnAPVZ5U8O2YqGdx/8MawbwmRaT2EgXKYQ==","signatures":[{"sig":"MEYCIQCrywhLHQIiJbR1Dg3mmoks4RCLA5HT6gDQgMXj7zqMfgIhAPwVu6Hs/NOssJsQ7WB/IHKTwdlpejElJFWQU/oWHoSM","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":154316},"main":"build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"901c43a2675ba4084d49d7cd0464254187894dc5","scripts":{"dev":"tsc --watch","test":"npm run build && node --test test/**/*.test.js","build":"tsc","start":"node build/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"btafoya","email":"btafoya@briantafoya.com"},"repository":{"url":"git+https://github.com/btafoya/flarum-mcp-server.git","type":"git"},"_npmVersion":"11.16.0","description":"MCP server for Flarum forum - CRUD operations for discussions, posts, users, and tags","directories":{},"_nodeVersion":"24.14.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/flarum-mcp-server_1.0.2_1782006012582_0.3933267718049729","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@btafoya/flarum-mcp-server","version":"1.1.0","description":"MCP server for Flarum forum - CRUD operations for discussions, posts, users, and tags","type":"module","main":"build/index.js","bin":{"flarum-mcp-server":"build/index.js"},"scripts":{"build":"tsc","start":"node build/index.js","dev":"tsc --watch","test":"npm run build && node --test test/**/*.test.js","prepublishOnly":"npm run build"},"keywords":["mcp","flarum","forum","claude","anthropic","model-context-protocol"],"author":{"name":"Brian Tafoya","email":"btafoya@briantafoya.com"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/btafoya/flarum-mcp-server.git"},"homepage":"https://github.com/btafoya/flarum-mcp-server#readme","bugs":{"url":"https://github.com/btafoya/flarum-mcp-server/issues"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^20.0.0","typescript":"^5.0.0"},"engines":{"node":">=18.0.0"},"gitHead":"8d99d1a47234a6c78189c0d0525900c135ea2e74","types":"./build/index.d.ts","_id":"@btafoya/flarum-mcp-server@1.1.0","_nodeVersion":"24.14.0","_npmVersion":"11.16.0","dist":{"integrity":"sha512-T7qNXso+n+q8XPkW0BkYvDNqqg0+SqWBSdtrmdx9xMfRLVgJwh6OJ/9sRkQXt3j4FJdZlXDwnRZym7yH4c3ozQ==","shasum":"fdbae9403f3817fcc527eada71456b1982a5351e","tarball":"https://registry.npmjs.org/@btafoya/flarum-mcp-server/-/flarum-mcp-server-1.1.0.tgz","fileCount":30,"unpackedSize":181042,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFR+wx/LPjPZcLutcch1BCttdrYPFLsCUOc3NWEg5XRtAiAmpX3F/u8uSkd2avFYzwRUDprJXrecfJdycA1N79qLQg=="}]},"_npmUser":{"name":"btafoya","email":"btafoya@briantafoya.com"},"directories":{},"maintainers":[{"name":"btafoya","email":"btafoya@briantafoya.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/flarum-mcp-server_1.1.0_1782048046468_0.20817285279692888"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-21T00:35:50.642Z","modified":"2026-06-21T13:20:46.705Z","1.0.0":"2026-06-21T00:35:51.087Z","1.0.1":"2026-06-21T01:14:57.441Z","1.0.2":"2026-06-21T01:40:12.706Z","1.1.0":"2026-06-21T13:20:46.619Z"},"bugs":{"url":"https://github.com/btafoya/flarum-mcp-server/issues"},"author":{"name":"Brian Tafoya","email":"btafoya@briantafoya.com"},"license":"MIT","homepage":"https://github.com/btafoya/flarum-mcp-server#readme","keywords":["mcp","flarum","forum","claude","anthropic","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/btafoya/flarum-mcp-server.git"},"description":"MCP server for Flarum forum - CRUD operations for discussions, posts, users, and tags","maintainers":[{"name":"btafoya","email":"btafoya@briantafoya.com"}],"readme":"# Flarum MCP Server\n\nA [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for [Flarum](https://flarum.org/) forums. This allows Claude Code and other MCP clients to interact with Flarum forums - creating, reading, updating, and deleting discussions, posts, users, and tags.\n\n## Installation\n\n### Global install (recommended)\n\n```bash\nnpm install -g @btafoya/flarum-mcp-server\n```\n\n### npx (no install)\n\n```bash\nclaude mcp add flarum \\\n  -e FLARUM_BASE_URL=https://your-forum.com \\\n  -e FLARUM_USERNAME=your-email@example.com \\\n  -e FLARUM_PASSWORD=your-password \\\n  -- npx @btafoya/flarum-mcp-server\n```\n\n## Claude Code CLI\n\nAdd the server to Claude Code:\n\n```bash\nclaude mcp add flarum \\\n  -e FLARUM_BASE_URL=https://your-forum.com \\\n  -e FLARUM_USERNAME=your-email@example.com \\\n  -e FLARUM_PASSWORD=your-password \\\n  -- flarum-mcp-server\n```\n\nIf the environment variables are not picked up after running the command above, add the server manually in `~/.claude/settings.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"flarum\": {\n      \"command\": \"flarum-mcp-server\",\n      \"env\": {\n        \"FLARUM_BASE_URL\": \"https://your-forum.com\",\n        \"FLARUM_USERNAME\": \"your-email@example.com\",\n        \"FLARUM_PASSWORD\": \"your-password\"\n      }\n    }\n  }\n}\n```\n\nRemove the server from Claude Code:\n\n```bash\nclaude mcp remove flarum\n```\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `FLARUM_BASE_URL` | Yes | Your Flarum forum URL |\n| `FLARUM_USERNAME` | No | Email or username for auto-login |\n| `FLARUM_PASSWORD` | No | Password for auto-login |\n\n## Available Tools\n\n### Discussions\n\n| Tool | Description |\n|------|-------------|\n| `flarum_list_discussions` | List discussions (supports filtering by user, tag, date) |\n| `flarum_get_discussion` | Get discussion details |\n| `flarum_create_discussion` | Create a new discussion |\n| `flarum_update_discussion` | Update a discussion |\n| `flarum_delete_discussion` | Delete/hide a discussion |\n\n### Posts\n\n| Tool | Description |\n|------|-------------|\n| `flarum_list_posts` | List posts in a discussion |\n| `flarum_get_post` | Get post details |\n| `flarum_create_post` | Create a reply |\n| `flarum_update_post` | Update a post |\n| `flarum_delete_post` | Delete/hide a post |\n\n### Users\n\n| Tool | Description |\n|------|-------------|\n| `flarum_list_users` | List users (supports search) |\n| `flarum_get_user` | Get user details |\n| `flarum_create_user` | Create a new user |\n| `flarum_update_user` | Update a user |\n| `flarum_delete_user` | Delete a user |\n\n### Tags\n\n| Tool | Description |\n|------|-------------|\n| `flarum_list_tags` | List all tags |\n\n### Authentication\n\n| Tool | Description |\n|------|-------------|\n| `flarum_login` | Login to the forum |\n| `flarum_logout` | Logout |\n| `flarum_check_auth` | Check authentication status |\n\n## Usage Examples\n\nIn Claude Code, you can say:\n\n- \"List the latest 10 discussions\"\n- \"Create a new discussion titled 'Hello World' with content 'This is my first post'\"\n- \"Reply to discussion 123 with 'Thanks for sharing!'\"\n- \"Show me all discussions by user john\"\n- \"Get discussions created after 2024-01-01\"\n\n## Features\n\n- **Auto-login**: Configure credentials in environment variables for automatic authentication\n- **Token caching**: Tokens are cached locally (`~/.flarum-mcp-token.json`) with 5-year expiration\n- **Filtering**: Filter discussions by user, tag, and date range\n- **Soft delete**: Default delete operation hides content (recoverable), with option for permanent deletion\n\n## Requirements\n\n- Node.js >= 18.0.0\n- A Flarum forum with API access\n\n## Development\n\n```bash\n# Clone and install dependencies\ngit clone https://github.com/btafoya/flarum-mcp-server.git\ncd flarum-mcp-server\nnpm install\n\n# Build\nnpm run build\n\n# Watch mode\nnpm run dev\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}