@Furkankoykiran/Coderlegion

CI npm version GitHub Package License: MIT Node.js

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	create_post, edit_post, delete_post, get_post, list_posts, add_comment
Profile	get_profile, edit_profile
Search	search_posts, browse_tag, get_categories
Social	react_to_post, get_notifications, get_activity_feed

---

Prerequisites

1. Node.js 20+ (node --version)
2. 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-mcp

Option 2 — Install globally from npm

npm install -g @furkankoykiran/coderlegion-mcp
CODERLEGION_PHPSESSID=xxx CODERLEGION_QA_SESSION=xxx coderlegion-mcp

Option 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-mcp

Option 4 — Build from source

git clone https://github.com/furkankoykiran/coderlegion-mcp.git
cd coderlegion-mcp
npm install
npm run build
node build/index.js

---

Configuration

The server is configured entirely via environment variables — no config file needed.

Variable	Default	Description
CODERLEGION_PHPSESSID	(empty)	PHP session ID — required
CODERLEGION_QA_SESSION	(empty)	Q2A session cookie — required
CODERLEGION_QA_NOTICED	1	Notice acknowledgement cookie

Getting your cookies

1. Log in to coderlegion.com in your browser
2. Open Developer Tools (F12) > Application > Cookies > https://coderlegion.com
3. Copy the values for PHPSESSID and qa_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-mcp

---

Available 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
title	string	Yes	Post title
content	string	Yes	Post content in Markdown
tags	string	Yes	Comma-separated tags, max 4 (e.g. python,automation,mcp)
category	enum	Yes	2 Articles, 5 Tutorials, 1971 Launches, 2005 Videos
draft	boolean	No	Save as draft (default: false)
schedule_time	string	No	Publish time: YYYY-MM-DDThh:mm
schedule_utc	string	No	Timezone offset in minutes for scheduling
source_url	string	No	Source URL for attribution
os_type	enum	No	Project or Product (Launches only)
os_tagline	string	No	Short tagline (Launches only)
repo_url	string	No	Repository URL (Launches only)
web_url	string	No	Website/demo URL (Launches only)
os_status	enum	No	Active, Development, Experimental, Archived, None (Launches only)
os_license	enum	No	1 MIT, 2 Apache 2.0, 3 GPL v3, 4 BSD, 5 Other (Launches only)
os_availability	enum	No	Free, Paid, Trial, None (Launches only)
vdo_type	string	No	Video type e.g. Tutorials, Product Demos (Videos only)
vdo_url	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
id	string	Yes	Post ID (numeric)
slug	string	Yes	Post URL slug
title	string	No	New title
content	string	No	New Markdown content
tags	string	No	New comma-separated tags
category	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
id	string	Yes	Post ID (numeric)
slug	string	Yes	Post URL slug

get_post

Retrieve a post's title, content snippet, tags, and author information.

Parameter	Type	Required	Description
id	string	Yes	Post ID (numeric)
slug	string	Yes	Post URL slug

list_posts

Retrieve all posts by a specific CoderLegion user.

Parameter	Type	Required	Description
username	string	Yes	CoderLegion username

add_comment

Add a Markdown comment to a post thread.

Parameter	Type	Required	Description
id	string	Yes	Post ID (numeric)
slug	string	Yes	Post URL slug
content	string	Yes	Comment text in Markdown
comment_id	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
name	string	No	Full display name
tagline	string	No	Short tagline/headline shown under the name
about	string	No	About/bio section
location	string	No	Location (e.g. Istanbul, Türkiye)
website	string	No	Personal website URL
skills	string	No	Skills description
interests	string	No	Interests description
achievements	string	No	Achievements description
fun_fact	string	No	Fun fact about you
quote	string	No	Favorite quote

---

Search

search_posts

Full-text search across all CoderLegion posts.

Parameter	Type	Required	Description
query	string	Yes	Search query

browse_tag

Browse posts filtered by a specific tag.

Parameter	Type	Required	Description
tag	string	Yes	Tag name (e.g. python, javascript)

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
post_id	string	Yes	Post ID to react to
type	enum	Yes	like or love

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 build

Testing with MCP Inspector

npx @modelcontextprotocol/inspector node build/index.js

Set 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.