# Reportei MCP for AI Agents AI Agent Connect

> Reportei lets you pull marketing performance data from Google, Facebook, and Instagram directly into your AI chat. It handles the heavy lifting of gathering metrics and project details so you can focus on strategy instead of copy-pasting numbers into spreadsheets. Use it to generate reports, track project timelines, and manage client metadata without leaving your favorite AI client.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_3ZfcpniEPF6ymeWDiQmzUEvVZm8wf5n7XPgowF7T/ai-agent-connect
- **Tags:** marketing-analytics, performance-reporting, social-media-metrics, ad-reporting, data-consolidation, client-reporting

## Description

Reportei connects your marketing data from Google, Facebook, and Instagram directly to your AI chat. It handles the heavy lifting of gathering metrics and project details so you can focus on strategy instead of copy-pasting numbers into spreadsheets. You can see your entire portfolio of marketing projects and check which integrations are active in real-time. It's a way to turn your AI into a dedicated marketing analyst that knows your history and can pull real-time data on the fly. By using this through the Vinkius catalog, you get a direct line into your Reportei account. You can create new reports, log events on your project timelines, and get a bird's-eye view of your marketing performance without ever touching a raw data file. It makes the transition from gathering data to analyzing results almost instant. Instead of spending your Monday morning opening five different tabs to find out how a campaign performed, you can just ask your agent for the highlights. It handles the connection to your social accounts and ad platforms, meaning you don't have to worry about manual data entry or broken links. Whether you're checking if a specific post went viral or need to see the total reach for the month, the data is always just one prompt away. It's about moving faster and getting more accurate insights without the usual friction of manual reporting.

## Tools

### add_reportei_event
Adds a new milestone or action to your project timeline. It keeps your project history accurate and up to date.

### get_client
Pulls specific metadata and details for a single client. This gives you the high-level info needed for account management.

### list_clients
Shows a full list of all clients in your Reportei account. This makes it easy to navigate between different brand portfolios.

### get_reportei_metrics
Pulls raw performance data from your connected marketing channels. This helps you see real-time engagement and reach numbers.

### get_report_details
Shows specific details for a single analytics report. You can use this to see the breakdown of a specific past project.

### list_integrations
Shows every connected platform like Google Ads or Instagram. Use this to check if your data sources are still active.

### list_reportei_projects
Lists all the marketing projects you currently manage. It gives you a quick way to see your entire workload.

### list_reportei_reports
Shows all generated reports, which you can filter by project. This helps you find old reports for specific clients.

### list_reportei_timeline
Shows the history of events and actions on your project timelines. Use it to see exactly when specific milestones were hit.

### create_report
Generates a brand new analytics report for your marketing data. This is the primary way to build new client-facing documents.

## Prompt Examples

**Prompt:** 
```
What was the engagement rate on our Instagram campaign last month?
```

**Response:** 
```
### Instagram Campaign Performance
**Month:** October 2025

| Metric | Value | Change |
| :--- | :--- | :--- |
| **Reach** | 142,000 | +12% |
| **Engagements** | 8,400 | +5% |
| **Engagement Rate** | 5.9% | +0.4% |

**Top Performing Post:** 
*   *Video Reel: "Summer Sale Highlights"* - 45K views, 1.2K likes.
```

**Prompt:** 
```
Give me a status update on all my active marketing projects.
```

**Response:** 
```
### Active Projects Overview

*   **Main Brand Launch:** In Progress (Next milestone: Creative Approval)
*   **Retailer X Campaign:** Completed (Report generated)
*   **Social Growth Initiative:** Active (3 events logged this week)

*Would you like to see the specific timeline for any of these?*
```

**Prompt:** 
```
Create a new performance report for the 'Summer Sale' project.
```

**Response:** 
```
### Report Generation

I've generated a new performance report for the **Summer Sale** project.

**Summary of included data:**
*   Google Ads Spend & Conversions
*   Instagram Reach & Engagement
*   Facebook Click-Through Rates

The report is now available in your Reportei dashboard for viewing and export.
```

## Capabilities

### Pull raw metrics from social channels
Reportei pulls raw engagement and reach data from your connected social accounts.

### Generate new analytics reports
Reportei creates new performance reports based on your current marketing data.

### List all active marketing projects
Reportei shows every marketing project you currently have in your account.

### View specific client metadata
Reportei retrieves detailed information for individual clients in your portfolio.

### Track project timeline events
Reportei logs and lists milestones and actions on your marketing project timelines.

### Check status of connected integrations
Reportei shows which platforms like Google Ads or Instagram are currently active.

### Retrieve detailed report performance data
Reportei pulls specific performance metrics from previously generated reports.

## Use Cases

### Quick campaign performance check
A social media manager asks their agent for the Instagram reach of a post from last week to see if a recent campaign worked.

### Agency project status overview
An agency owner wants to see every active project and their current timeline status to prepare for a team meeting.

### Consolidated data for analysis
A data analyst needs to pull raw metrics for a specific client to see how Google Ads spend correlates with social engagement.

### Logging project milestones
A project manager logs a new campaign launch as a timeline event to keep the client updated on progress.

## Benefits

- Stop manual data collection by using get_reportei_metrics to pull social and ad data into your chat instantly.
- Save hours of prep time by using create_report to generate new analytics reports with one simple command.
- Keep your project history organized by using add_reportei_event to log milestones directly from your AI client.
- Get a bird's-eye view of your portfolio by using list_reportei_projects to see all managed accounts at once.
- Verify your data sources quickly with list_integrations to ensure all platforms are syncing correctly.

## How It Works

The bottom line is you stop hunting for data and start using it immediately.

1. Connect your Reportei API token to the Connector.
2. Ask your AI client to list projects or pull metrics for a specific client.
3. Receive formatted data or generated reports directly in your chat interface.

## Frequently Asked Questions

**Can Reportei MCP pull data from multiple social platforms?**
Yes, it pulls data from Instagram, Facebook, and Google Ads into one place so you don't have to check them individually.

**How does the Reportei MCP help marketing agencies?**
It automates the report generation process, saving you from manually compiling data into spreadsheets for your clients.

**Can I use Reportei MCP to track my project milestones?**
Yes, you can log events to your project timeline to keep a history of actions and milestones for every client.

**Does the Reportei MCP require me to manually enter metrics?**
No, it pulls raw data directly from your connected integrations like Google Ads and social networks.

**How does Reportei MCP handle different client accounts?**
It allows you to list all clients and projects, making it easy to manage multiple accounts within a single chat interface.

**Can I filter reports by project in Reportei MCP?**
Yes, the Connector can list reports filtered by specific project IDs to help you find the right data quickly.

**Can my AI automatically find the details for a specific project just by providing its ID?**
Yes! Use the `list_reportei_projects` tool. Your agent will respond with complete metadata for all your projects, allowing you to identify and inspect individual client accounts in seconds.

**How do I find my Reportei API Token?**
Log in to your Reportei account, navigate to **Settings** > **Company** > **Reportei API**, and you will find your unique secret token there.

**Can I retrieve metrics for a specific date range?**
Yes, using the `get_reportei_metrics` tool, you can provide `start_date` and `end_line` parameters to fetch consolidated marketing data for any specific period.