Skip to main content
The Nudj MCP Server connects Nudj features to AI agents through the Model Context Protocol. It runs over HTTP on port 4010 or via stdio for compatible clients.

​
Install

pnpm install
pnpm dev   # HTTP server at http://localhost:4010
pnpm stdio # stdio transport for desktop clients
The dev server disables TLS verification so it can talk to self-signed Nudj APIs.

​
Integrate

​
Claude Desktop

  1. Create or update ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows) with:
{
  "mcpServers": {
    "nudj": {
      "command": "pnpm",
      "args": ["--filter", "@nudj-digital/mcp-server", "stdio"]
    }
  }
}
  1. Restart Claude Desktop and select the nudj MCP server.

​
Cursor

  1. In Cursor, open Settings → MCP Servers.
  2. Add a new server with the command:
pnpm --filter @nudj-digital/mcp-server stdio
  1. The server will be available in the MCP panel.

​
Tools

​
Nudj platform

​
communities

Create, list, and manage communities.

​
challenges

Manage challenges throughout their lifecycle.

​
actions

List, create, fetch, or update engagement actions.

​
achievements

Create, retrieve, update, or delete badges and milestones.

​
rewards

Query or update rewards.

​
reward_allocations

Distribute rewards to users.

​
posts

Publish or edit admin posts.

​
Utilities

​
web

Search the web or scrape page content.

​
social_posts

Retrieve social media posts.

​
youtube_channel

Fetch channel information and video listings.

​
youtube_video

Get video details and transcripts.

​
image

Generate or edit images.

​
nudj_docs

Search the Nudj documentation.

​
watch

Subscribe to Nudj events and receive real-time updates.

​
Agent modes

The server filters tool access based on the x-agent-mode header:
  • planner – read-only operations.
  • builder – create or update Nudj resources.
  • service – access public web and media tools.
⌘I