# PoetryDB MCP for AI Agents AI Agent Connect

> PoetryDB MCP. Access the world's largest database of public domain poetry. Search by author, title, lines, or line count directly from your AI agent. This Connector connects you to thousands of classic literary works for research, creative writing, and deep analysis of historical texts.

## Overview
- **Category:** databases
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_YcnkFJi1Hx6l5SBu0tKEHdwBITXWQTE2gHEWAanZ/ai-agent-connect
- **Tags:** poetry, literature, public-domain, search-engine, literary-analysis

## Description

Connect this Connector to your agent to turn it into a digital librarian and literary scholar. Instead of digging through messy online archives or copy-pasting from multiple websites, you can just ask your agent to find specific works or explore a poet's catalog. You'll get immediate access to thousands of classic poems and literary pieces. If you're looking for a specific style, like a 14-line sonnet by a specific author, the agent handles the heavy lifting. You can also pull random poems for inspiration or hunt for specific phrases hidden within classic lines. It works perfectly within the Vinkius catalog, making it easy to plug into your existing setup. It's about getting the right text at the right time without the friction of manual searching. You can browse entire catalogs of authors or titles to see what's available, or you can combine multiple filters to find exactly what you need for a project. You can look for a specific keyword in a classic text or see what a famous poet wrote. This connection makes that data instantly available for your agent to process and share with you.

## Tools

### list_titles
Get a complete list of all poem titles available in the database. Use this to see the full scope of the collection.

### search_by_author
Find poems by an author's name using partial or exact matches. This is useful for exploring a specific poet's entire body of work.

### search_by_linecount
Filter the database for poems that have a specific number of lines. Use this to find specific forms like sonnets.

### search_by_lines
Search for specific phrases or keywords within the lines of poems. This helps find works containing specific themes or words.

### search_by_title
Locate poems by their title using partial or exact matching. This is the fastest way to find a known literary work.

### advanced_search
Run complex queries combining multiple fields like author, title, and line count. This provides precise filtering for research.

### list_authors
Get a list of all authors currently in the PoetryDB. This is great for browsing the database's available poets.

### get_random_poems
Pull a set of random poems from the database for inspiration. Use this to discover new authors or styles quickly.

## Prompt Examples

**Prompt:** 
```
Find 3 random poems for me.
```

**Response:** 
```
Here are 3 random selections from the database:

| Title | Author |
| :--- | :--- |
| **Ozymandias** | Percy Bysshe Shelley |
| **The Raven** | Edgar Allan Poe |
| **A Bird, came down the Walk** | Emily Dickinson |

Shall I provide the full text for any of these?
```

**Prompt:** 
```
Search for poems by John Keats that have exactly 14 lines.
```

**Response:** 
```
Searching for sonnets by John Keats... I found several matches, including:

* **On First Looking into Chapman's Homer**
* **When I have fears that I may cease to be**

Both are 14-line sonnets. Which one would you like to read?
```

**Prompt:** 
```
List all authors available in the PoetryDB.
```

**Response:** 
```
I've retrieved the list of authors. There are hundreds of poets available, including classics like **William Shakespeare**, **Emily Dickinson**, and **Edgar Allan Poe**. Would you like to see poems from a specific author?
```

## Capabilities

### Search by author
Find poems by a specific poet or a partial name.

### Search by line count
Filter poems based on their exact number of lines.

### Search by lines
Find poems that contain specific phrases or keywords within their lines.

### Search by title
Locate poems by their title using partial or exact matching.

### List titles
Get a complete list of all poem titles available in the database.

### Advanced search
Run complex queries combining multiple fields like author, title, and line count.

### List authors
Get a list of all authors currently in the database.

### Get random poems
Pull a set of random poems from the database for quick inspiration.

## Use Cases

### Studying sonnet structures
A writer wants to find a 14-line sonnet by Keats to study its structure. The agent uses search_by_author and search_by_linecount to find the exact match.

### Analyzing a poet's bibliography
A student needs to find every poem by Emily Dickinson in a database. The agent uses list_authors and search_by_author to compile a full list.

### Testing NLP models
A developer wants to pull random poems to test a text analysis tool. The agent uses get_random_poems to feed the model diverse literary data.

### Keyword research in classics
A researcher is looking for specific keywords within 18th-century poetry. The agent uses search_by_lines to scan the database for those terms.

## Benefits

- Get instant access to thousands of classic poems without browsing multiple websites.
- Find specific sonnets or poems using search_by_linecount for precise literary research.
- Discover new styles by pulling random poems with get_random_poems.
- Search for specific phrases within classic works using search_by_lines.
- Filter large catalogs quickly by combining multiple criteria with advanced_search.
- Browse complete collections of poets and titles with list_authors and list_titles.

## How It Works

The bottom line is you get instant access to a massive public domain literary database through a simple chat interface.

1. Subscribe to this Connector on Vinkius.
2. Set your access identifier to 'PUBLIC'.
3. Ask your agent to find poems or list authors.

## Frequently Asked Questions

**Can I use PoetryDB MCP to find classic sonnets?**
Yes, you can find specific sonnets by searching for authors and using line count filters to isolate 14-line works.

**Does PoetryDB MCP include copyrighted works?**
No, it focuses on public domain poetry, which makes it safe for various research and projects.

**How do I find poems with specific phrases?**
You can use the search by lines feature to find any poem containing specific keywords or unique phrases.

**Can I use PoetryDB MCP for academic research?**
Yes, it's a great tool for finding specific literary works and analyzing author collections for school or professional research.

**Is there a way to get random inspiration?**
Yes, you can ask your agent to pull a set of random poems from the database to get a feel for different styles.

**Can I search for poems by a specific number of lines?**
Yes, the tool allows you to filter the database by exact line counts, which is perfect for finding specific poetic forms.

**Can I search for poems that contain specific words or phrases in their text?**
Yes! Use the `search_by_lines` tool. Provide a string, and the agent will return poems that include that specific text within their lines.

**Is it possible to find a poem if I only know the author and the approximate length?**
Absolutely. You can use the `advanced_search` tool to combine fields like 'author' and 'linecount' to narrow down the results to exactly what you're looking for.

**How can I discover new poets I haven't read before?**
You can use `list_authors` to see the full directory of available poets, or use `get_random_poems` to have the agent surprise you with a random selection from the database.