Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
NODELOC_LOCALENoDefault zh-CN (used by the check-in request header)zh-CN
NODELOC_APPS_CLINonodeloc-apps CLI path, defaults to PATH lookup, required for apps tools
NODELOC_BASE_URLNoDefault https://www.nodeloc.comhttps://www.nodeloc.com
NODELOC_DATA_DIRNoSession/docs cache directory, default ~/.nodeloc-mcp~/.nodeloc-mcp
NODELOC_PASSWORDYesForum password (only used to obtain a cookie session; the session is stored in a local file)
NODELOC_TIMEZONENoDefault Asia/ShanghaiAsia/Shanghai
NODELOC_USERNAMEYesForum username or email (required)
NODELOC_PAYMENT_IDNoPayment app ID (pay_xxx), required for payment tools, apply at https://www.nodeloc.com/payment/applications
NODELOC_PAYMENT_TOKENNoPayment app token (tk_xxx), required for payment tools
NODELOC_SECOND_FACTOR_METHODNo2FA: 0 none / 1 SMS / 2 TOTP, default 00

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
get_current_userA

Get the currently logged-in NodeLoc user (id, username, trust level, unread notification counts). Logs in automatically if needed.

list_latest_topicsA

List latest topics on the forum homepage. Anonymous; page starts at 0.

list_top_topicsA

List top/trending topics. Anonymous.

read_topicA

Read a topic with its posts (trimmed HTML bodies). Anonymous.

list_category_topicsB

List topics in a category. filter is typically 'latest' or 'top'. Anonymous.

get_site_infoA

Get site configuration: categories (id/name/slug) etc. Anonymous.

get_user_profileA

Get a user's public profile (trust level, bio, stats). Anonymous.

get_user_summaryB

Get a user's activity summary (posts, likes, badges). Anonymous.

search_usersA

Search users by name/username, e.g. to resolve @mentions or PM recipients.

list_notificationsA

List notifications for the logged-in user (mentions, replies, likes, PMs).

mark_notifications_readA

Mark all notifications as read, or a single one when notification_id is given.

list_private_messagesA

List private-message topics of a user (defaults to the logged-in user).

create_topicA

Create a new topic. raw is Markdown; category_id from get_site_info.

reply_to_topicB

Reply to a topic (Markdown body). Optionally reply to a specific post number.

send_private_messageC

Send a private message. recipients: comma-separated usernames.

like_postC

Like a post.

unlike_postB

Remove a like from a post.

bookmark_postC

Bookmark a post.

vote_pollC

Vote in a poll attached to a post. options: the chosen option values.

unvote_pollC

Retract a poll vote.

list_nodesA

List all nested communities (nodes) and my memberships.

list_node_topicsB

List topics inside a node (nested community).

join_nodeC

Join a node (nested community).

leave_nodeC

Leave a node (nested community).

create_nodeC

Create a new node (nested community). color is an optional hex color.

check_node_slugA

Check whether a node slug is available before creating a node.

get_chat_messagesB

Fetch messages of a chat channel (paginated).

get_chat_thread_messagesC

Fetch messages of a chat thread inside a channel.

send_chat_messageB

Send a chat message to a channel, optionally into a thread.

mark_chat_readA

Mark a chat channel as read up to a message id.

checkinA

Perform the daily check-in and collect energy points. Once per day; a repeated call returns the 'already checked in' result from the server.

create_red_envelopeA

Create a red envelope in a topic: total_points energy split into total_count shares, claimable by users who reply.

give_rewardB

Tip energy points to the author of a post.

get_points_historyA

Get energy points income/expense history (defaults to the logged-in user).

get_points_scoresA

Get energy points score breakdown (defaults to the logged-in user).

payment_createA

Create a payment request (official Payment API). Returns a payment_url the buyer must open to pay. order_id is your unique order reference.

payment_queryC

Query the status of a payment transaction (official Payment API).

payment_transferA

Transfer energy points from the payment-app owner to a user (official Payment API). to_user_id and to_username must refer to the same user. Sender pays a trust-level-based fee; idempotent per order_id.

docs_list_pagesA

List all pages of the NodeLoc knowledge base (title, url, description).

docs_get_pageA

Fetch a knowledge-base page as Markdown. page can be a full URL, a path like 'energy/checkin', or a title fragment from docs_list_pages.

docs_searchA

Search the knowledge base by keyword (titles, descriptions, cached bodies).

apps_cliA

Run an official nodeloc-apps CLI command for in-site miniprograms, e.g. 'init my-app', 'playtest', 'submit'. Requires the CLI installed and logged in (interactive login must be done once in a terminal yourself). cwd: project directory to run in.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Patrick130306/nodeloc-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server