# Adviceslip MCP

> Adviceslip connects your AI agent to a database of over ten million human pieces of advice. Get instant inspiration by asking for random wisdom, searching through specific keywords like 'friendship' or 'success', or pulling up a precise quote using its unique identifier.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** advice, wisdom, quotes, inspiration, daily-tips

## Description

Need a quick dose of perspective? This MCP feeds your AI client a massive library of human wisdom. Instead of digging through forums or browsing endless articles, you can ask for inspiration directly within your workflow. You just tell your agent what kind of thought you're looking for—a general uplift, advice on career moves, or something about relationships—and it pulls an appropriate slip from the database. If you're building a feature into an app, this is great for adding 'Quote of the Day' functionality. Because Vinkius hosts this MCP alongside thousands of others, you get access to this massive pool of thought while keeping your AI client connected everywhere.

## Tools

### adviceslip_get_by_id
Looks up and returns a single advice slip when you provide its unique numerical ID.

### adviceslip_get_random
Pulls a completely random piece of wisdom for instant, unguided inspiration.

### adviceslip_search
Searches the entire database and returns all advice slips containing your chosen keyword or phrase.

## Prompt Examples

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

**Response:** 
```
I've fetched a random advice slip for you: 'Remember that as far as anyone else is concerned, you're just another person in the street.' (ID: 142)
```

**Prompt:** 
```
Search for advice about 'spiders'.
```

**Response:** 
```
I found an advice slip about spiders: 'If you're ever attacked by a group of clowns, go for the juggler.' Wait, that's a joke! Let me find a real one... 'Never trust a spider.' (ID: 83)
```

**Prompt:** 
```
What is the advice slip with ID 50?
```

**Response:** 
```
Advice slip #50 is: 'Don't always take advice from others.' A bit ironic, isn't it?
```

## Capabilities

### Get Random Wisdom
Instantly retrieves a spontaneous piece of advice without needing any search terms.

### Search by Topic
Finds all available pieces of advice that contain a specific word or phrase you provide.

### Look Up Specific Advice
Retrieves an exact piece of wisdom when you know its unique numeric ID.

## Use Cases

### Writing an article about personal growth
Instead of searching Google for general advice, ask your agent to use `adviceslip_search` with the term 'friendship'. The agent returns several relevant quotes instantly, saving you 30 minutes of research time and giving your piece depth.

### Creating a daily reminder feature in an app
The system can call `adviceslip_get_random` every morning to pull the 'Advice of the Day.' This keeps the content fresh, unique, and ready for deployment without needing manual database updates.

### Testing a quote-based UI element
If you need to showcase how your app handles specific pieces of wisdom, use `adviceslip_get_by_id` to retrieve known content (e.g., ID 50) for testing consistency.

## Benefits

- Stop staring at a blank page. With `adviceslip_get_random`, you get an immediate thought starter, whether you're writing copy or brainstorming project names.
- Need material quickly? Use `adviceslip_search` to pull dozens of quotes about 'resilience' in seconds, perfect for compiling blog posts on leadership.
- Building a tool that needs specific content? You can use `adviceslip_get_by_id` to guarantee you retrieve the exact quote needed without guessing.
- It removes the friction of finding inspiration. Instead of opening a new tab and scrolling through motivational quotes, you ask your agent directly.
- Boost your client's utility by adding a 'Daily Insight' feature that pulls wisdom on demand, improving user engagement.

## How It Works

The bottom line is you get instant access to millions of quotes without leaving your current AI conversation.

1. Subscribe to this MCP in Vinkius and connect your preferred AI client.
2. Ask your agent for the type of advice you need, whether it's random or tied to a specific concept like 'patience'.
3. The MCP sends the request to the database and returns the relevant advice slip directly into your chat window.

## Frequently Asked Questions

**How do I find advice about a specific topic using Adviceslip MCP?**
Use the `adviceslip_search` tool. Just tell your agent to search for 'leadership' or 'money,' and it will pull all relevant quotes from the massive database.

**Do I need to authenticate to use Adviceslip MCP?**
No, this is a public API. You don't need any special keys or credentials; you just subscribe and start asking your AI client.

**If I want a random quote, which tool do I use with Adviceslip MCP?**
You should use `adviceslip_get_random`. This is the simplest way to get an immediate piece of wisdom without having to think of keywords.

**Can I retrieve a specific quote using Adviceslip MCP?**
Yes, you can use `adviceslip_get_by_id`. If you know the unique number associated with a slip, this is the fastest and most direct way to get it.