@furkankoykiran/coderlegion-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@furkankoykiran/coderlegion-mcp create a new post announcing my new project"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@furkankoykiran/coderlegion-mcp
TypeScript MCP server for CoderLegion — connect AI agents (Claude, Cursor, Cline) to the developer community platform.
Built with the official MCP TypeScript SDK, it exposes 13 tools covering post management, profile editing, content search, and social interactions — all accessible from any MCP-compatible client.
Features
Category | Tools |
Posts |
|
Profile |
|
Search |
|
Social |
|
Related MCP server: mcpcodeserver
Prerequisites
Node.js 20+ (
node --version)A CoderLegion account with valid session cookies
Installation
Option 1 — Run directly with npx (no install required)
CODERLEGION_PHPSESSID=xxx CODERLEGION_QA_SESSION=xxx npx @furkankoykiran/coderlegion-mcpOption 2 — Install globally from npm
npm install -g @furkankoykiran/coderlegion-mcp
CODERLEGION_PHPSESSID=xxx CODERLEGION_QA_SESSION=xxx coderlegion-mcpOption 3 — Install from GitHub Packages
npm install -g @furkankoykiran/coderlegion-mcp --registry=https://npm.pkg.github.com
CODERLEGION_PHPSESSID=xxx CODERLEGION_QA_SESSION=xxx coderlegion-mcpOption 4 — Build from source
git clone https://github.com/furkankoykiran/coderlegion-mcp.git
cd coderlegion-mcp
npm install
npm run build
node build/index.jsConfiguration
The server is configured entirely via environment variables — no config file needed.
Variable | Default | Description |
| (empty) | PHP session ID — required |
| (empty) | Q2A session cookie — required |
|
| Notice acknowledgement cookie |
Getting your cookies
Log in to coderlegion.com in your browser
Open Developer Tools (F12) > Application > Cookies >
https://coderlegion.comCopy the values for
PHPSESSIDandqa_session
MCP Client Setup
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"coderlegion": {
"command": "npx",
"args": ["-y", "@furkankoykiran/coderlegion-mcp"],
"env": {
"CODERLEGION_PHPSESSID": "your-php-session-id",
"CODERLEGION_QA_SESSION": "your-qa-session-value"
}
}
}
}VS Code (Cline / Continue)
Add to your MCP server settings:
{
"coderlegion": {
"command": "npx",
"args": ["-y", "@furkankoykiran/coderlegion-mcp"],
"env": {
"CODERLEGION_PHPSESSID": "your-php-session-id",
"CODERLEGION_QA_SESSION": "your-qa-session-value"
}
}
}Built from source
{
"coderlegion": {
"command": "node",
"args": ["/absolute/path/to/coderlegion-mcp/build/index.js"],
"env": {
"CODERLEGION_PHPSESSID": "your-php-session-id",
"CODERLEGION_QA_SESSION": "your-qa-session-value"
}
}
}Claude Code (CLI)
claude mcp add -s user coderlegion \
-e CODERLEGION_PHPSESSID=your-php-session-id \
-e CODERLEGION_QA_SESSION=your-qa-session-value \
-- npx -y @furkankoykiran/coderlegion-mcpAvailable Tools
Posts
create_post
Create a new post on CoderLegion. Supports Articles, Tutorials, Launches, and Videos with Markdown content, scheduling, and category-specific fields.
Note: CoderLegion enforces a maximum of 4 tags per post.
Parameter | Type | Required | Description |
| string | Yes | Post title |
| string | Yes | Post content in Markdown |
| string | Yes | Comma-separated tags, max 4 (e.g. |
| enum | Yes |
|
| boolean | No | Save as draft (default: false) |
| string | No | Publish time: |
| string | No | Timezone offset in minutes for scheduling |
| string | No | Source URL for attribution |
| enum | No |
|
| string | No | Short tagline (Launches only) |
| string | No | Repository URL (Launches only) |
| string | No | Website/demo URL (Launches only) |
| enum | No |
|
| enum | No |
|
| enum | No |
|
| string | No | Video type e.g. |
| string | No | Video URL e.g. YouTube link (Videos only) |
edit_post
Edit an existing post's title, content, tags, or category. Only the fields you provide are changed; everything else remains as-is.
Parameter | Type | Required | Description |
| string | Yes | Post ID (numeric) |
| string | Yes | Post URL slug |
| string | No | New title |
| string | No | New Markdown content |
| string | No | New comma-separated tags |
| enum | No | New category ID |
delete_post
Hide (soft-delete) a post. The post becomes invisible to other users but is not permanently removed.
Parameter | Type | Required | Description |
| string | Yes | Post ID (numeric) |
| string | Yes | Post URL slug |
get_post
Retrieve a post's title, content snippet, tags, and author information.
Parameter | Type | Required | Description |
| string | Yes | Post ID (numeric) |
| string | Yes | Post URL slug |
list_posts
Retrieve all posts by a specific CoderLegion user.
Parameter | Type | Required | Description |
| string | Yes | CoderLegion username |
add_comment
Add a Markdown comment to a post thread.
Parameter | Type | Required | Description |
| string | Yes | Post ID (numeric) |
| string | Yes | Post URL slug |
| string | Yes | Comment text in Markdown |
| string | Yes | Comment thread ID (from the post page) |
Profile
get_profile
Get the authenticated user's CoderLegion profile information — name, tagline, location, website, about, skills, interests, achievements, fun fact, and quote. No parameters required.
edit_profile
Edit the authenticated user's profile. Only the fields you provide are updated; others remain unchanged.
Parameter | Type | Required | Description |
| string | No | Full display name |
| string | No | Short tagline/headline shown under the name |
| string | No | About/bio section |
| string | No | Location (e.g. |
| string | No | Personal website URL |
| string | No | Skills description |
| string | No | Interests description |
| string | No | Achievements description |
| string | No | Fun fact about you |
| string | No | Favorite quote |
Search
search_posts
Full-text search across all CoderLegion posts.
Parameter | Type | Required | Description |
| string | Yes | Search query |
browse_tag
Browse posts filtered by a specific tag.
Parameter | Type | Required | Description |
| string | Yes | Tag name (e.g. |
get_categories
Retrieve all post categories with their IDs and descriptions. No parameters required.
Social
react_to_post
React to a post with a like or love. Calling again on the same post toggles the reaction off.
Parameter | Type | Required | Description |
| string | Yes | Post ID to react to |
| enum | Yes |
|
get_notifications
Retrieve your notification feed (comments, reactions, follows). No parameters required.
get_activity_feed
Retrieve the social activity feed from followed users. No parameters required.
Development
# Clone and install
git clone https://github.com/furkankoykiran/coderlegion-mcp.git
cd coderlegion-mcp
npm install
# Run in development mode (auto-reloads on change)
npm run dev
# Type-check
npm run typecheck
# Build for production
npm run buildTesting with MCP Inspector
npx @modelcontextprotocol/inspector node build/index.jsSet the environment variables in the Inspector UI and verify all 13 tools are listed.
Contributing
Contributions are welcome. Please read the contributing guidelines and open an issue before submitting a pull request for significant changes.
License
MIT — see LICENSE.
Available Tools
14 toolsadd_commentC
Add a comment to a CoderLegion post
Inputs: id (required), slug (required), content (required), comment_id (required).
browse_tagB
Browse posts by tag on CoderLegion
Inputs: tag (required).
create_postC
Create a new post on CoderLegion. Supports Articles, Tutorials, Launches, and Videos.
Inputs: tags (required), title (required), content (required), category (required), +13 more.
delete_postB
Hide (soft-delete) a post on CoderLegion. The post becomes invisible to other users.
Inputs: id (required), slug (required).
edit_postC
Edit an existing post on CoderLegion
Inputs: id (required), slug (required), tags, title, +2 more.
edit_profileB
Edit the authenticated user's CoderLegion profile. Only specified fields are updated; others remain unchanged.
Inputs: name, about, quote, skills, +6 more.
get_activity_feedA
Get the CoderLegion social activity feed from followed users
Inputs: no named parameters.
get_categoriesA
List all CoderLegion post categories with their IDs
Inputs: no named parameters.
get_notificationsB
Get your CoderLegion notifications
Inputs: no named parameters.
get_postA
Read a post from CoderLegion and return its title, content snippet, tags, and author
Inputs: id (required), slug (required).
get_profileA
Get the authenticated user's CoderLegion profile information
Inputs: no named parameters.
list_postsC
List posts by a CoderLegion user
Inputs: username (required).
react_to_postC
React to a CoderLegion post with a like or love
Inputs: type (required), post_id (required).
search_postsC
Search for posts on CoderLegion
Inputs: query (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 14 tools
Most tools target a distinct action+resource, but the read-side of posts has four overlapping entry points (list_posts, search_posts, browse_tag, get_activity_feed) that an agent could easily confuse when just wanting to find posts. The descriptions do differentiate them (by user, query, tag, followed users), so ambiguity is manageable rather than severe.
Every tool follows a clean verb_noun snake_case pattern (get_post, create_post, edit_post, delete_post, add_comment, react_to_post, get_profile, edit_profile). No mixed conventions or vague verbs appear anywhere in the set.
14 tools is well within the sweet spot for a social/blogging platform and each one maps to a real user-facing operation. Nothing feels padded or redundant at the count level.
Posts have full lifecycle coverage (create, get, list, search, browse, edit, soft-delete) plus comments, reactions, categories, profile, notifications, and a feed. Minor gaps exist on the secondary resources — no delete/unreact for reactions, no comment listing or deletion — but these are workable omissions.
Maintenance
Related MCP Connectors
A simple Typescript MCP server built using the official MCP Typescript SDK and smithery/cli. This…
A TypeScript MCP server for Home Assistant, enabling programmatic management of entities, automati…
MCP server for Pinchwork - an agent-to-agent task marketplace with credits-based economy
Official MCP server for Agentwork — delegate tasks to AI agents with human-in-the-loop
Related MCP Servers
- AlicenseCqualityDmaintenanceA TypeScript-based MCP server designed for experimentation and integration with Calude Desktop and Cursor IDE, offering a modular playground for extending server capabilities.2547 npm7MIT
- AlicenseNot gradedqualityDmaintenanceProxy MCP server that translates tool calls into TypeScript code generation, enabling LLMs to orchestrate multi-tool workflows efficiently via code.92 npm14MIT
- AlicenseAqualityAmaintenanceProduction-ready template for building MCP servers with TypeScript, featuring example tools and resources, and Claude Desktop integration.110 npmMIT
- AlicenseNot gradedqualityDmaintenanceA TypeScript template for building MCP servers, enabling developers to create custom tools for AI assistants like Claude.7 npmMIT