Skip to content
Nerdy beta

MCP Server

Resource Mcp AI

This collection exposes a Model Context Protocol server so your AI tools can query it directly: searching notes, reading full content, browsing by tag or category, and following backlinks. The endpoint is read-only and works without authentication for public content. Gated workshop notes return their excerpt with gated: true unless you authenticate with an account that has the required entitlement.

Endpoint

https://nerdnoir.ai/api/mcp

Transport: streamable HTTP (MCP 2025-11-25 spec).

What the Server Exposes

Tools

ToolWhat it does
search_collectionKeyword search. Returns ranked hits with title, slug, category, tags, excerpt, and relevance score.
get_noteFetch the full markdown body of a note by slug. Authenticated users with entitlements see gated content unlocked.
list_by_tagAll notes matching a given tag.
list_by_categoryAll notes in a top-level category (concepts, tools, workshops, etc.).
list_backlinksNotes that wikilink to a given slug.

Resources

Every published note is addressable as collection://note/{slug}. Clients that support the resources primitive can browse the collection natively.

Connecting Claude Desktop

Claude Desktop supports custom connectors — remote MCP servers you add straight from settings. No local bridge, no npx, no config file to edit. It also runs the OAuth sign-in for you, so gated workshop notes unlock for accounts with the entitlement.

  1. Open Claude Desktop and go to Settings → Connectors.
  2. Click + then Add custom connector.
  3. Enter a name (nerdy) and the server URL: https://nerdnoir.ai/api/mcp
  4. Click Add. To unlock gated content, complete the sign-in prompt when it appears.

The collection’s tools show up in the tool picker (the hammer icon); notes appear in the attach menu under resources.

Custom connectors are available on Free, Pro, Max, Team, and Enterprise plans; Free accounts are limited to one. On Team and Enterprise, an owner adds the connector under Settings → Organization Settings → Connectors first.

Connecting Claude Code

Claude Code supports remote MCP servers natively. To add it for your personal use across all projects:

claude mcp add --transport http --scope user nerdy https://nerdnoir.ai/api/mcp

To share it with everyone on a project (writes to .mcp.json in the repo root):

claude mcp add --transport http --scope project nerdy https://nerdnoir.ai/api/mcp

Or add it manually by creating .mcp.json at the project root:

{
  "mcpServers": {
    "nerdy": {
      "type": "http",
      "url": "https://nerdnoir.ai/api/mcp"
    }
  }
}

Once configured, run /mcp inside Claude Code to complete the OAuth sign-in (for gated content) and confirm the server shows as connected. Claude Code can then call collection tools mid-conversation — ask it to search the collection, pull in a concept, or list notes by tag.

Connecting Claude on the Web (claude.ai)

Custom remote MCP connectors are available on Free, Pro, Max, Team, and Enterprise plans. Free accounts are limited to one custom connector.

  1. Go to Settings → Connectors on claude.ai (or navigate directly to claude.ai/settings/connectors).
  2. Click + then Add custom connector.
  3. Enter a name (nerdy) and the server URL: https://nerdnoir.ai/api/mcp
  4. Click Add. The collection tools become available in your conversations.

Team and Enterprise accounts manage connectors under Settings → Organization Settings → Connectors.

Connecting ChatGPT

ChatGPT supports MCP natively via Developer Mode (beta, available on Plus, Pro, Business, Enterprise, and Education plans — not available on Free).

  1. Go to Settings → Apps and toggle on Developer mode in Advanced settings.
  2. Then go to Settings → Connectors → Create.
  3. Enter a name, description, and the endpoint URL: https://nerdnoir.ai/api/mcp

ChatGPT’s MCP client speaks streamable HTTP directly — no bridge or proxy needed. The integration is still rolling out and capabilities vary by plan; check OpenAI’s documentation for the current state.

Connecting Cursor

Cursor speaks streamable HTTP directly. Add the server to your MCP config using whichever scope fits:

Global (~/.cursor/mcp.json) — applies across all your projects:

{
  "mcpServers": {
    "nerdy": {
      "url": "https://nerdnoir.ai/api/mcp"
    }
  }
}

Project-level (.cursor/mcp.json in the repo root) — applies only to that project, overrides global:

{
  "mcpServers": {
    "nerdy": {
      "url": "https://nerdnoir.ai/api/mcp"
    }
  }
}

After saving, open Settings → MCP in Cursor and confirm nerdy is listed and enabled — Cursor gates MCP behind a per-server toggle, so a newly added entry doesn’t always turn itself on. If the tools don’t show up in a chat, run MCP: View Server Status from the command palette to check the connection.

Debugging with MCP Inspector

npx @modelcontextprotocol/inspector https://nerdnoir.ai/api/mcp

This launches a web UI where you can call each tool, browse resources, and inspect JSON-RPC messages.

Authentication

The server supports OAuth 2.0 for MCP clients that want to access gated workshop content. If your client supports it (Claude Code does natively), the flow is:

  1. Your client discovers the OAuth server via /.well-known/oauth-protected-resource.
  2. It registers itself dynamically and opens a browser for you to log in.
  3. If you’re already logged into the site, the authorization step completes immediately.
  4. Your client receives a token and includes it in subsequent MCP requests.

Once authenticated, get_note and resource reads return the full markdown body for any gated note your account has access to. The response includes unlocked: true so your client knows it received the full content.

Authentication is optional. Without it, all public content works normally and gated notes return their excerpt.

Rate Limits

Anonymous callers are capped at 120 MCP requests per hour per IP. If you hit the ceiling the server returns HTTP 429 with a Retry-After header. Contact david@nerdnoir.com if your use case needs a higher ceiling.