{"_id":"@dennisk2025/random-advice-slip","name":"@dennisk2025/random-advice-slip","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@dennisk2025/random-advice-slip","version":"1.0.0","description":"Fetches a random piece of advice, offering helpful or thoughtful suggestions from the Advice Slip API.","type":"module","main":"index.js","bin":{"random-advice-slip":"index.js"},"dependencies":{"@modelcontextprotocol/sdk":"latest","axios":"latest"},"author":{"name":"dennisk2025"},"license":"MIT","_id":"@dennisk2025/random-advice-slip@1.0.0","_nodeVersion":"22.20.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-rTOFINW6jyuBib1AIBTf1he7gnQtcbwG5pUAIB3kCve0pHnd4ffRd7cAusvDnP0K25EWnM4LUo5SOxqeio6k2A==","shasum":"96cf43f3577c4aeff65f7dbdcb8df0842f530949","tarball":"https://registry.npmjs.org/@dennisk2025/random-advice-slip/-/random-advice-slip-1.0.0.tgz","fileCount":3,"unpackedSize":5593,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIA6DSDuxV077HKdlY81e00icOyXqwd8CQNJfc7ns7aehAiEAlyYvNDMUrIghYeUTv4VuFozILASUiI5uL/88T5eaagI="}]},"_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/random-advice-slip_1.0.0_1761425850053_0.13148703986649846"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-25T20:57:29.967Z","1.0.0":"2025-10-25T20:57:30.243Z","modified":"2025-10-25T20:57:30.888Z"},"maintainers":[{"name":"dennisk2025","email":"4dennisk@gmail.com"}],"description":"Fetches a random piece of advice, offering helpful or thoughtful suggestions from the Advice Slip API.","author":{"name":"dennisk2025"},"license":"MIT","readme":"# random-advice-slip\n\nFetches a random piece of advice, offering helpful or thoughtful suggestions from the Advice Slip API.\n\nThis Model Context Protocol (MCP) server exposes a single tool to fetch truly random advice slips. Simple, friendly, and useful—direct from the classic https://api.adviceslip.com!\n\n## Features\n- Fetches a random advice slip from the Advice Slip API\n- Returns both unique advice ID and advice text\n- Zero external or API key setup required\n\n## Installation\n### With npx (recommended)\nRun directly (no global install needed):\n\n```sh\nnpx @dennisk2025/random-advice-slip\n```\n\n### With npm\nFirst install as a dependency:\n\n```sh\nnpm install @dennisk2025/random-advice-slip\n```\n\nThen run:\n\n```sh\nnpx random-advice-slip\n```\n\n## Adding to Claude Desktop\nTo use this MCP server in Claude Desktop, add the following to your Claude configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"advice\": {\n      \"command\": \"npx\",\n      \"args\": [\"@dennisk2025/random-advice-slip\"]\n    }\n  }\n}\n```\n\nAdd this to your Claude Desktop config file at:\n- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\nThen restart Claude Desktop to load the advice server.\n\n## Usage\n\nOnce running, you can ask Claude (or your MCP client) to use the available tool:\n\n### Available Tools\n- **get_random_advice**\n  - *Description*: Returns a random advice slip, including its unique ID and the advice text.\n  - *Parameters*: _none_\n\n### Example Calls\n#### 1. List all tools\n*Claude MCP will send a ListTools request and see the following tool:*\n\n- `get_random_advice` (Returns a random advice slip, including its unique ID and the advice text)\n\n#### 2. Call get_random_advice\nInput:\n```json\n{\n  \"name\": \"get_random_advice\",\n  \"arguments\": {}\n}\n```\n\nResponse:\n```json\n{\n  \"id\": 17,\n  \"advice\": \"Never give up on your dreams.\"\n}\n```\n\n## Tool Details\n\n| Name               | Parameters | Description                                                             |\n|--------------------|------------|-------------------------------------------------------------------------|\n| get_random_advice  | None       | Returns a random advice slip, including its unique ID and the advice text|\n\n---\n\nThis MCP server is open, fast, and doesn't require any authentication. Enjoy your advice!\n","readmeFilename":"README.md","_rev":"1-69c32bfc9c289a9b477890dbe7d4b7f1"}