Receipts in Free & Pro Tiers

Receipts is a Vendia feature that automatically captures and records all operations performed through the Vendia MCP Gateway. For Free Tier users, Receipts provide complete visibility into API Connection calls and Storage Connection file operations, making it easier to audit activity, analyze usage patterns, and ensure compliance.

What Gets Tracked

Receipts are automatically created for all MCP Server operations in the Free Tier:

1. API Reads - When API GET requests are made through Vendia MCP Gateway API Connections
2. API Writes - When API POST, PUT, or DELETE requests are made through Vendia MCP Gateway API Connections
3. Storage Connection List - When Storage Connections are listed through Vendia MCP Gateway
4. Storage Connection Read - When Storage Connection metadata is read through Vendia MCP Gateway
5. File Reads - When Storage Connection files are read through Vendia MCP Gateway
6. File Creates - When Storage Connection files are created through Vendia MCP Gateway
7. File Writes - When Storage Connection files are written through Vendia MCP Gateway
8. File Deletes - When Storage Connection files are deleted through Vendia MCP Gateway
9. MCP Tool Usage - When remote MCP Server tools are used through the Vendia MCP Gateway

How Receipts Work

Timing and Frequency

Receipts are created in batches for efficiency, while preserving their correct chronological order:

• Default Batch Window: 5 minutes (300 seconds)
• Default Batch Size: 25 receipts per batch
• Maximum Batch Size: 100 receipts per batch
• Maximum Wait Time: 5 minutes (300 seconds)

Information Captured

Each Receipt contains:

• Actor Information: User ID and authentication type
• Client Type: How the request was made (MCP, UI, etc.)
• Operation Details: Type of operation performed
• Timestamp: When the operation occurred
• Status: Success or failure of the operation
• Error Details: If the operation failed, includes error message (truncated to 500 characters)

Accessing Receipts

Using the Vendia Console

Receipts are available through the Vendia web interface:

1. Navigate to the Observe Page: From your Free Tier dashboard, click on the “Observe” tab
2. Select Receipts: Look for the “Receipts” tab within the Observe page
3. View and Filter: Browse through the receipts with built-in filtering and sorting options

The Receipts interface allows you to:

• View receipts in chronological order
• Filter by time range, operation type, or status
• Sort results by most recent activity
• Monitor your Free Tier usage

Use Cases for Free Tier

Activity Monitoring

• Track all AI application interactions with your data
• Monitor which files are being accessed through Storage Connections
• Review API Connection usage patterns

Usage Analysis

• Understand which operations consume your Free Tier limits
• Identify frequently accessed files or API endpoints
• Optimize your MCP Server usage based on actual patterns

Troubleshooting

• Diagnose failed operations with detailed error messages
• Review operation timing to identify performance issues
• Verify that AI applications are correctly accessing your resources

Compliance and Audit

• Maintain audit trails of all data access operations
• Track who accessed specific files or API endpoints
• Generate reports for compliance requirements

Free Tier Limits

Receipts are included as part of the Free Tier.