# Favqs MCP

> Favqs lets you access a massive database of quotes, turning inspiration into actionable content. Fetch the Quote of the Day for daily social posts, search by author or tag instantly, and build out your own curated library of sayings right from your agent's chat window. It’s designed to make finding that perfect line—whether for a presentation or just a personal note—a simple command away.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** quotes, inspiration, author-search, community, quote-management

## Description

Need fresh content ideas? This MCP connects you to the world's quote database, giving you instant access to wisdom and inspiration without leaving your workflow. You can start by running `get_qotd` to grab today’s featured quote, perfect for social media or a quick morning message. If you need something specific, searching is easy; just ask your agent to find quotes filtered by author, tag, or keyword using the search tools. Beyond reading, you build a personal collection: save favorites and add tags directly through commands like `favorite_quote`. For content creators, it lets you do more than just read—you can even use `add_quote` to contribute your own sayings to the community. This full suite of quote management happens via Vinkius, meaning your agent talks to this tool seamlessly, regardless of which AI client you prefer.

## Tools

### add_quote
Adds a brand new quote after you've created a user session.

### clearvote_quote
Removes your vote from a specific quote when you change your mind.

### create_session
Establishes a temporary user session and gets you the necessary User-Token for personalized actions.

### create_user
Creates an entirely new account profile on Favqs.

### delete_quote
Deletes a private quote you wrote (requires Pro status).

### destroy_session
Ends your current user session, clearing the temporary token.

### downvote_quote
Registers a downvote on a quote after you've created a user session.

### favorite_quote
Adds an existing quote to your private list of favorites (requires a session).

### follow
Starts tracking content from another user, author, or tag.

### forgot_password
Requests an email to help you recover a forgotten password.

### get_activity
Fetches a feed showing what other users have been doing on the platform.

### get_followers
Lists all accounts that are following your current profile.

### get_following
Shows which specific users, authors, or tags you have decided to follow.

### get_qotd
Grabs the Quote of the Day without needing any special login credentials.

### get_quote
Retrieves a single quote when you know its unique ID number.

### get_typeahead
Provides lists of public authors, tags, and users to help autocomplete your search queries.

### get_user
Pulls up the profile details for any specific user account.

### hide_quote
Hides a quote from your view after you've created a user session.

### list_quotes
Searches and returns multiple quotes based on complex filters (author, tag, keywords).

### publicize_quote
Changes a quote you wrote from private to public (requires Pro status).

### reset_password
Resets your password using a recovery token.

### tag_quote
Adds custom, personal tags to an existing quote (requires session).

### unfavorite_quote
Removes a saved favorite from your list.

### unfollow
Stops tracking content from a specific user, author, or tag.

### unhide_quote
Makes a previously hidden quote visible again (requires session).

### update_quote
Edits the text of your private quotes (requires Pro status).

### update_user
Changes details on your personal profile, like name or bio.

### upvote_quote
Registers a positive vote for a quote (requires session).

## Prompt Examples

**Prompt:** 
```
Get the quote of the day.
```

**Response:** 
```
The Quote of the Day is: 'Life is what happens when you're busy making other plans.' - John Lennon. Would you like to save this to your favorites?
```

**Prompt:** 
```
Find some quotes about 'courage' by Winston Churchill.
```

**Response:** 
```
I found several quotes. One notable one is: 'Success is not final, failure is not fatal: it is the courage to continue that counts.' Should I list more from this author?
```

**Prompt:** 
```
Favorite the quote with ID 12345.
```

**Response:** 
```
I've successfully added quote 12345 to your favorites. You can view your full list of favorites anytime using `list_quotes`.
```

## Capabilities

### Access Daily Quotes
Retrieve the featured Quote of the Day with a single command.

### Search and Filter Wisdom
Find specific quotes by filtering results using authors, tags, or keywords.

### Curate Personal Libraries
Save quotes as favorites, upvote them for quality signals, or tag them to categorize your personal collection.

### Manage User Following
Track content by following specific authors, tags, or other users within the platform.

### Contribute Content
Create and update private quotes to share them with your community.

## Use Cases

### Drafting an Executive Summary
A communications director needs three strong opening lines for a presentation. Instead of googling 'best quotes about leadership,' they ask their agent to run `list_quotes` with the tag 'leadership' and filter by author, getting several options instantly.

### Curating Blog Content
A blogger is building a post on historical figures. They use `get_typeahead` to find all relevant authors, then run `list_quotes` multiple times, finally using `favorite_quote` to build their source material.

### Managing Community Profiles
A brand manager wants to keep tabs on competitors' thought leaders. They use the agent to `follow` specific competitor accounts and check the feed via `get_activity` for new insights.

### Updating Personal Records
Someone needs to update their bio or professional profile. They first run `get_user` to see current details, then use `update_user` to make the necessary changes directly through the MCP.

## Benefits

- Never stare at a blank screen again. You can use `get_qotd` to grab a ready-to-use piece of inspiration for social media, saving you the initial brainstorming time.
- Need deep context? Instead of manual searching across multiple websites, your agent handles complex filtering through tools like `list_quotes`, finding quotes by specific authors or tags instantly.
- Building a personal knowledge base is simple. You can use `favorite_quote` and then categorize that collection using `tag_quote` without ever leaving your chat window.
- Keep track of who’s speaking on the topic. Follow key thought leaders, and monitor their activity feed via `get_activity` to stay ahead of trends.
- Need to correct or improve a quote? You can use `update_quote` for private drafts, ensuring your personal content remains accurate before you even publish it.

## How It Works

The bottom line is you give the token to Vinkius, and your AI client talks to the quote database using structured commands.

1. First, connect your preferred AI client through Vinkius and subscribe to this Favqs MCP using your App Token.
2. Next, if you plan on actions like favoriting or tagging, run `create_session` to generate a User-Token for personalized access.
3. Finally, tell your agent what you need—like 'Find quotes about leadership' or 'What's the Quote of the Day?'—and it handles the rest.

## Frequently Asked Questions

**How do I use the `get_qotd` tool with Favqs?**
Just ask your agent to 'Get today's quote.' This function doesn't require any authentication and simply retrieves the featured Quote of the Day for you.

**Can I manage my favorites using `favorite_quote` if I don't have an account?**
No. You must run `create_session` first to get a User-Token. The system needs to know who is saving the quote before it can use `favorite_quote`.

**What if I want to find quotes by a specific author? Should I use `list_quotes` or `get_user`?**
Use `list_quotes`. That tool is designed for searching and filtering content, allowing you to specify the author name in your query parameters.

**Is it possible to write my own quotes using Favqs? Which tool handles that?**
Yes, you can use `add_quote` or `update_quote`. Remember these actions require a user session token for authentication.

**If I want to save a quote or manage my profile, do I need to use `create_session` first?**
Yes, you must call `create_session` before accessing private tools. This process obtains your User-Token, which authenticates you and allows the system to perform actions like favoriting quotes or viewing your activity feed.

**How do I track specific authors or topics using the `follow` tool?**
You use `follow` to subscribe to any user, author, or tag. After following someone, you can check their new content and see your relationship status by calling `get_following`. This keeps your curated feeds current.

**What is the difference between adding a quote and using `tag_quote`?**
While `add_quote` creates the text, `tag_quote` attaches descriptive metadata to an existing quote. You use tags (like 'courage' or 'business') to organize content, making it easier to filter results later with `list_quotes`.

**Before I search using `list_quotes`, how can I find available authors and tags?**
Use the `get_typeahead` tool. This fetches a list of public Authors, Tags, and Users for autocomplete suggestions. It’s the best way to confirm valid search parameters before running a detailed query.

**How do I find the daily featured quote?**
Simply use the `get_qotd` tool. It fetches the current 'Quote of the Day' from Favqs without requiring any specific parameters.

**Can I search for quotes by a specific author or tag?**
Yes! Use the `list_quotes` tool. You can provide a keyword in the `filter` parameter and specify the `type` (e.g., 'author' or 'tag') to narrow down your results.

**Do I need a user session for all actions?**
No. Public actions like `get_qotd` and `list_quotes` only require an App Token. However, personalized actions like `favorite_quote`, `follow`, or `add_quote` require a User Token, which you can obtain by running `create_session` with your credentials.