# Papertrail MCP for AI Agents AI Agent Connect

> Papertrail MCP lets you manage and search cloud logs in real-time via your AI agent. You can search millions of events, list active systems, and organize log groups directly from your chat or code editor. It bridges the gap between your infrastructure and your AI workflow, making troubleshooting much faster.

## Overview
- **Category:** devops-cicd
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_9zuWcznPmEpcj53ajo1LLYJOL1wJjgvObjPqdqek/ai-agent-connect
- **Tags:** logging, real-time-logs, cloud-monitoring, event-search, syslog

## Description

Imagine you're in the middle of a production outage. Usually, you'd have to jump between browser tabs, copy-paste log snippets, and hunt through nested menus to find the root cause. With this Connector, you just tell your agent what's happening. You can ask it to look for specific error codes, check the health of your active systems, or see what's happening on a specific system right now. It pulls your logs directly into your conversation, so you can focus on fixing the problem instead of searching for the data. Whether you're organizing log groups to keep things tidy or checking where your logs are being sent, it handles the heavy lifting. It's one of the many tools available in the Vinkius catalog that turns your AI into a first-class operator for your cloud infrastructure. You get a direct line to your logs, making real-time debugging feel like a conversation rather than a manual chore. You can quickly identify errors and performance bottlenecks by querying logs directly from your development environment. Instead of manually scrolling through thousands of lines of text, your agent summarizes the relevant events. This means you spend less time on data retrieval and more time on actual engineering tasks. It bridges the gap between your cloud logs and your daily workflow, providing a clear window into your infrastructure's health.

## Tools

### create_group
Create a new log group to organize your systems into categories. It makes it easier to filter logs by service type.

### list_destinations
List all existing log destinations in your account. Use this to see where your data is being sent currently.

### list_groups
List all log groups to see your current organization. This helps you avoid creating duplicate categories.

### search_events
Search through millions of log events using specific keywords. This is the primary way to find errors and traces quickly.

### create_destination
Create a new log destination to control where your data goes. This helps you manage your archives and data flow.

### list_systems
List all systems currently sending logs to your account. Use this to verify that your infrastructure is reporting correctly.

## Prompt Examples

**Prompt:** 
```
Show me all the systems currently sending logs to my account.
```

**Response:** 
```
I've retrieved your systems. You have 3 active systems:

| System Name | ID |
| :--- | :--- |
| **web-prod-01** | 101 |
| **db-master** | 102 |
| **api-gateway** | 103 |

All systems are currently reporting correctly.
```

**Prompt:** 
```
Search for 'Auth_Failure' in the logs from the last 30 minutes.
```

**Response:** 
```
Searching events... I found 14 occurrences of `Auth_Failure` in the last 30 minutes. 

**Summary:**
- **Most Frequent Source:** `api-gateway` (9 occurrences)
- **Status:** These appear to be related to a spike in failed login attempts from a single IP range.

Would you like to see the full log entries for the `api-gateway` failures?
```

**Prompt:** 
```
Create a new log group called 'Payment-Gateway' for system ID 202.
```

**Response:** 
```
Successfully created the log group `Payment-Gateway` (ID: 505) containing system 202. 

You can now filter searches specifically for this group to keep your payment logs isolated.
```

## Capabilities

### Search millions of log events
Find specific error traces or patterns across your entire log history using natural language.

### View all active systems
Get a complete list of every system currently sending logs to your account.

### Create and list log groups
Organize your infrastructure into logical categories to make filtering much easier.

### View and configure log destinations
See where your data is being archived or forwarded and manage those settings easily.

### Tail live logs for real-time debugging
Watch live events as they happen to catch and fix issues the moment they occur.

## Use Cases

### Outage Triage
An engineer asks the agent to find 'ConnectionTimeout' errors in the last hour across all systems to identify the failing service.

### New Service Onboarding
A developer asks the agent to create a new log group for a newly deployed microservice to ensure it's categorized correctly.

### Audit Check
A sysadmin wants to see all active systems and their current log destinations to ensure the logging pipeline meets compliance.

### Debugging a specific API
A developer asks the agent to search for a specific Request ID to trace a failed transaction through the logs.

## Benefits

- Stop manual log hunting by using `search_events` to find specific error traces instantly.
- Get a bird's-eye view of your infrastructure by using `list_systems` to see every active source.
- Keep your logs organized by using `create_group` and `list_groups` to manage categories.
- Control your data flow by using `list_destinations` and `create_destination` to manage archives.
- Debug faster by using live tailing and pagination through the `search_events` tool.

## How It Works

The bottom line is you get a direct, conversational interface to your entire Papertrail log history and infrastructure.

1. Subscribe to the Connector and provide your Papertrail API Token
2. Connect the Connector to your preferred AI client like Claude or Cursor
3. Ask your agent to search logs, list systems, or manage groups using natural language

## Frequently Asked Questions

**Can the Papertrail MCP search through my old logs?**
Yes, it allows you to search through millions of historical log events using your existing search syntax directly through your AI agent.

**How does the Papertrail MCP help with production outages?**
It lets you query logs in real-time using natural language, helping you find errors much faster than manual searching and filtering.

**Can I use the Papertrail MCP to organize my different systems?**
Yes, you can create and list log groups to categorize your infrastructure and keep your logs organized automatically.

**Does the Papertrail MCP allow me to see where my logs are going?**
You can use it to list and create log destinations, giving you clear visibility into where your data is being archived or forwarded.

**Is the Papertrail MCP compatible with Cursor and Claude?**
Yes, it works with any MCP-compatible client, including Claude, Cursor, Windsurf, and VS Code.

**How do I connect my Papertrail account to the Connector?**
You just need to provide your Papertrail API Token in your client settings after subscribing to the Connector via Vinkius.

**Can I search for specific error messages across all my logs?**
Yes! Use the `search_events` tool with the `q` parameter. You can use Papertrail's search syntax (e.g., 'error OR critical') to filter events across your systems.

**How do I see which servers or applications are currently sending logs?**
Simply run the `list_systems` tool. It will return a list of all systems configured in your Papertrail account, including their names and IDs.

**Can I create a new group to organize specific systems?**
Yes, use the `create_group` tool. You can provide a name and a comma-separated list of system IDs to group them together for easier monitoring.