# Advice Slip MCP

> Advice Slip MCP is a universal engine for wisdom retrieval. It gives your AI agent access to over 10 million pre-written life tips and advice quotes. Need random inspiration? Search by topic like 'career' or 'relationships'? Or maybe you just want the quote with ID #42? This MCP handles it all, turning vague prompts into concrete pieces of wisdom.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** random-advice, wisdom-engine, keyword-search, content-generation, api-utility

## Description

This connection equips your agent with a massive library of human insight. You don't have to search through endless articles for a good line; you just ask for advice. Your agent can pull completely random gems of wisdom, or pinpoint specific tips by their ID number. If you want something more focused, simply asking for keywords—like 'productivity' or 'love'—lets your agent find relevant passages across the entire database. It’s simple conversational retrieval. When connecting this MCP via Vinkius, you get immediate access to this massive resource through any compatible client, making your AI act like a digital sage ready whenever you are.

## Tools

### get_advice_by_id
Retrieves a specific piece of advice using its unique numerical identifier.

### get_random_advice
Pulls one random piece of life advice instantly.

### search_advice
Finds multiple pieces of advice based on a keyword or topic search.

## Prompt Examples

**Prompt:** 
```
Give me a random piece of advice.
```

**Response:** 
```
Here is a pearl of wisdom for you: 'Always drink a glass of water before you eat.' Would you like another one?
```

**Prompt:** 
```
Search for advice related to 'success'.
```

**Response:** 
```
I've searched the database for 'success'. Here is one for you: 'Success is a journey, not a destination.' I found several other slips; would you like me to list them all?
```

**Prompt:** 
```
What is the advice with ID 42?
```

**Response:** 
```
Retrieving advice slip #42... It says: 'Make choices and don't look back.' A very practical piece of wisdom. Do you have another specific ID in mind?
```

## Capabilities

### Generate random wisdom
You instantly receive a fresh piece of advice without needing any input keywords or IDs.

### Search for topic-specific tips
Your agent filters the entire database to find quotes related to specific words, like 'work' or 'life'.

### Fetch advice by unique ID
You tell your agent a number (the ID), and it pulls that exact piece of advice directly.

## Use Cases

### Need daily motivation for an internal newsletter
Instead of manually searching Google for inspirational quotes, the agent uses get_random_advice. It pulls a fresh piece of wisdom every morning and formats it into the draft email.

### Drafting content on 'career growth' for a blog
The writer asks the agent to search_advice using 'career'. The agent returns several quotes, allowing the writer to pick three distinct angles and build out the entire article.

### Building a quiz that requires specific trivia
A developer uses get_advice_by_id to pull known wisdom nuggets (like ID 42) directly into the app's database, adding flavor and depth without manual entry.

## Benefits

- Stop staring at a blank document. Need inspiration? Ask your agent to use get_random_advice and instantly pull a fresh, conversation-ready quote.
- Writing content about 'leadership'? Use search_advice with the keyword 'leadership'. You'll get several options so you don't sound repetitive week after week.
- You never have to guess which piece of advice worked best. If you know a great quote exists, use get_advice_by_id and pull it directly by its number.
- It saves time in content creation. Instead of opening ten different sites for quotes, your agent pulls everything from one source through this MCP.
- The agent acts like a digital research assistant, compiling multiple slips using search_advice to help you identify common themes across various topics.

## How It Works

The bottom line is, you talk to your agent like normal and it does the heavy lifting of searching millions of records.

1. Subscribe to this MCP within the Vinkius catalog.
2. Connect your preferred AI client, like Cursor or Claude, to the service.
3. Ask your agent for wisdom using natural language (e.g., 'Give me a random piece of advice' or 'Search for work tips').

## Frequently Asked Questions

**How do I get random advice using the get_random_advice tool?**
You ask your agent to retrieve a random piece of advice. It pulls a fresh, general quote immediately, perfect for filling out quick content spots.

**Can search_advice find quotes about niche topics?**
Yes, you simply provide the keyword. The MCP searches its entire database and returns all relevant tips associated with that specific topic.

**What if I only know the ID? Do I use get_advice_by_id?**
Absolutely. If you have a number, tell your agent to retrieve it using get_advice_by_id. It bypasses all searching and goes straight to the answer.

**Is there any limit to how many quotes I can find?**
The MCP draws from over 10 million slips, so you're unlikely to run into a content shortage. You just need to ask for it.

**How do I connect my agent to the Advice Slip MCP without needing an API key?**
You don't need one. This MCP is publicly accessible, so you just connect your AI client through Vinkius. You get immediate access for any compatible agent.

**What happens if I use the get_advice_by_id tool with an identifier that doesn't exist?**
The system returns a specific error message indicating the ID was not found. Your agent can then handle that error gracefully, letting you know to check the number.

**Can I pass search results from search_advice back to my AI client for deeper analysis?**
Yes. The tool returns structured data containing multiple advice slips. Your agent can then take that list and perform tasks like summarizing themes or identifying common keywords.

**Is there a limit on how many results I get when running search_advice for a popular keyword?**
The MCP is built to handle large datasets, drawing from over 10 million entries. You will receive a comprehensive set of relevant matches.

**Can I search for advice about 'money'?**
Yes! Use the `search_advice` tool with the keyword 'money'. It will return a list of all advice slips containing that word.

**How can I get advice by its ID number?**
Use the `get_advice_by_id` tool and provide the numerical ID of the advice slip you want to retrieve.

**Are the advice slips available in multiple languages?**
The original advice database is in English. However, your AI agent can translate any advice slip it retrieves into your preferred language instantly.