Urban Dictionary Lookup MCP Server

Fetches the top definition for a given term from Urban Dictionary, including the definition, example usage, author, and thumbs up/down counts.

Installation

You can easily run this MCP server with npx (no local install required):

npx @dennisk2025/urban-dictionary-lookup

Or install globally/local as a package:

npm install @dennisk2025/urban-dictionary-lookup

Adding to Claude Desktop

Add the following block to your claude_desktop_config.json file:

{
  "mcpServers": {
    "urban-dict": {
      "command": "npx",
      "args": ["@dennisk2025/urban-dictionary-lookup"]
    }
  }
}

Replace urban-dict with any short name you like.

Config file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Usage

This MCP server provides the following tool:

Tool: get_definition

• Description: Returns the top Urban Dictionary definition and example for a user-provided term.
• Parameters:
  • term (string, required): Term or phrase to look up (for example, "yeet", "FOMO").

Example Call

Input:

{
  "name": "get_definition",
  "arguments": {
    "term": "yeet"
  }
}

Response:

{
  "term": "yeet",
  "definition": "to throw something with a lot of force",
  "example": "He just yeeted his phone across the room!",
  "author": "urbanUser123",
  "thumbs_up": 4213,
  "thumbs_down": 133,
  "permalink": "https://www.urbandictionary.com/define.php?term=yeet"
}

Error Handling

• If the term is not found, you will receive a message indicating no definitions were found.
• API/network errors are gracefully handled.

Tools Reference

| Tool Name | Description | Parameters | |------------------|----------------------------------------------------------------|-----------------------------------------------------| | get_definition | Returns the top Urban Dictionary definition and example. | term (string, required): Term or phrase to look up. |

Questions or issues? Just re-run with npx!