{"_id":"@dennisk2025/urban-dictionary-lookup","name":"@dennisk2025/urban-dictionary-lookup","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@dennisk2025/urban-dictionary-lookup","version":"1.0.0","description":"Fetches the top definition for a given term from Urban Dictionary, including the definition, example usage, author, and thumbs up/down counts.","type":"module","main":"index.js","bin":{"urban-dictionary-lookup":"index.js"},"dependencies":{"@modelcontextprotocol/sdk":"latest","axios":"latest"},"author":{"name":"dennisk2025"},"license":"MIT","_id":"@dennisk2025/urban-dictionary-lookup@1.0.0","_nodeVersion":"22.20.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-ih1MnTiCz2hwq12IM9n3xa3n3wxprYDtWwF3EMUgr9CcPUOHf7pRbgFz8GeZZIacAliE1wTbE0AduHZL2EI7Eg==","shasum":"8361b335cf68d90a62eb7bbc3dff68b7c3abc543","tarball":"https://registry.npmjs.org/@dennisk2025/urban-dictionary-lookup/-/urban-dictionary-lookup-1.0.0.tgz","fileCount":3,"unpackedSize":6309,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQC4I9wxYdtO/dZNxqYYd6kBbKElK4R4X731SWQDq0PMSAIgZjIUjjCdyBlhxGykJxLOLcb1zvyUkX0tHDy3DgrcJTg="}]},"_npmUser":{"name":"dennisk2025","email":"4dennisk@gmail.com"},"directories":{},"maintainers":[{"name":"dennisk2025","email":"4dennisk@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/urban-dictionary-lookup_1.0.0_1761426723960_0.6968065681199136"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-25T21:12:03.885Z","1.0.0":"2025-10-25T21:12:04.145Z","modified":"2025-10-25T21:12:04.450Z"},"maintainers":[{"name":"dennisk2025","email":"4dennisk@gmail.com"}],"description":"Fetches the top definition for a given term from Urban Dictionary, including the definition, example usage, author, and thumbs up/down counts.","author":{"name":"dennisk2025"},"license":"MIT","readme":"# Urban Dictionary Lookup MCP Server\n\nFetches the top definition for a given term from Urban Dictionary, including the definition, example usage, author, and thumbs up/down counts.\n\n## Installation\n\nYou can easily run this MCP server with npx (no local install required):\n\n```\nnpx @dennisk2025/urban-dictionary-lookup\n```\n\nOr install globally/local as a package:\n\n```\nnpm install @dennisk2025/urban-dictionary-lookup\n```\n\n## Adding to Claude Desktop\n\nAdd the following block to your `claude_desktop_config.json` file:\n\n```json\n{\n  \"mcpServers\": {\n    \"urban-dict\": {\n      \"command\": \"npx\",\n      \"args\": [\"@dennisk2025/urban-dictionary-lookup\"]\n    }\n  }\n}\n```\n\nReplace `urban-dict` with any short name you like.\n\n**Config file locations:**\n- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n## Usage\n\nThis MCP server provides the following tool:\n\n### Tool: `get_definition`\n- **Description:** Returns the top Urban Dictionary definition and example for a user-provided term.\n- **Parameters:**\n  - `term` (**string**, required): Term or phrase to look up (for example, \"yeet\", \"FOMO\").\n\n#### Example Call\n\n**Input:**\n\n```json\n{\n  \"name\": \"get_definition\",\n  \"arguments\": {\n    \"term\": \"yeet\"\n  }\n}\n```\n\n**Response:**\n\n```json\n{\n  \"term\": \"yeet\",\n  \"definition\": \"to throw something with a lot of force\",\n  \"example\": \"He just yeeted his phone across the room!\",\n  \"author\": \"urbanUser123\",\n  \"thumbs_up\": 4213,\n  \"thumbs_down\": 133,\n  \"permalink\": \"https://www.urbandictionary.com/define.php?term=yeet\"\n}\n```\n\n## Error Handling\n- If the term is not found, you will receive a message indicating no definitions were found.\n- API/network errors are gracefully handled.\n\n## Tools Reference\n\n| Tool Name        | Description                                                    | Parameters                                          |\n|------------------|----------------------------------------------------------------|-----------------------------------------------------|\n| get_definition   | Returns the top Urban Dictionary definition and example.       | term (string, required): Term or phrase to look up. |\n\n---\n\nQuestions or issues? Just re-run with npx!\n","readmeFilename":"README.md","_rev":"1-c67d578b54c184bca01fc0e58c92836c"}