@dennisk2025/random-advice-slip
v1.0.0
Published
Fetches a random piece of advice, offering helpful or thoughtful suggestions from the Advice Slip API.
Readme
random-advice-slip
Fetches a random piece of advice, offering helpful or thoughtful suggestions from the Advice Slip API.
This 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!
Features
- Fetches a random advice slip from the Advice Slip API
- Returns both unique advice ID and advice text
- Zero external or API key setup required
Installation
With npx (recommended)
Run directly (no global install needed):
npx @dennisk2025/random-advice-slipWith npm
First install as a dependency:
npm install @dennisk2025/random-advice-slipThen run:
npx random-advice-slipAdding to Claude Desktop
To use this MCP server in Claude Desktop, add the following to your Claude configuration:
{
"mcpServers": {
"advice": {
"command": "npx",
"args": ["@dennisk2025/random-advice-slip"]
}
}
}Add this to your Claude Desktop config file at:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Then restart Claude Desktop to load the advice server.
Usage
Once running, you can ask Claude (or your MCP client) to use the available tool:
Available Tools
- get_random_advice
- Description: Returns a random advice slip, including its unique ID and the advice text.
- Parameters: none
Example Calls
1. List all tools
Claude MCP will send a ListTools request and see the following tool:
get_random_advice(Returns a random advice slip, including its unique ID and the advice text)
2. Call get_random_advice
Input:
{
"name": "get_random_advice",
"arguments": {}
}Response:
{
"id": 17,
"advice": "Never give up on your dreams."
}Tool Details
| Name | Parameters | Description | |--------------------|------------|-------------------------------------------------------------------------| | get_random_advice | None | Returns a random advice slip, including its unique ID and the advice text|
This MCP server is open, fast, and doesn't require any authentication. Enjoy your advice!
