NinjaCat MCP. Pull all ad data and reports into your chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
NinjaCat connects your AI agent directly to your agency account data. Use this server to pull marketing reports, list all advertisers, and check campaign status without logging into the NinjaCat portal.
Your agent runs tools like `list_advertisers` or `get_report_download_url` instantly.
What your AI agents can do
Get advertiser
Retrieves detailed information for one specific advertiser using their unique ID.
Get agency info
Pulls high-level metadata and settings for the entire NinjaCat agency account.
Get me
Retrieves current user profile details connected to the agency server.
The tool lists every advertiser managed by the agency, providing a complete roster of accounts.
It shows which marketing platforms (like Google or Meta) are currently linked to the NinjaCat account and how many individual data accounts exist.
You can list all available agency reports, check their execution history, and get a direct link to download the most recent file.
The tool lists active campaigns across the entire agency, letting you track where ad spend is currently focused.
By providing a unique ID, you can pull full metadata for any single advertiser or report instance.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
NinjaCat MCP Server: 10 Tools for Marketing Data
Use these tools to gather advertiser details, monitor campaign status, retrieve report history, and map all connected marketing accounts.
019d75ddget advertiser
Retrieves detailed information for one specific advertiser using their unique ID.
019d75ddget agency info
Pulls high-level metadata and settings for the entire NinjaCat agency account.
019d75ddget me
Retrieves current user profile details connected to the agency server.
019d75ddget report download url
Generates a direct download URL for the latest generated report file.
019d75ddget report history
Fetches the full execution history, including timestamps and success statuses, for any specific agency report.
019d75ddlist advertisers
Returns a list of all advertisers currently managed by the agency account.
019d75ddlist agency campaigns
Provides a listing of all active marketing campaigns across the entire agency scope.
019d75ddlist data accounts
Lists every connected data account, including specific accounts for platforms like Google Ads.
019d75ddlist data sources
Shows a list of all active marketing data sources connected to the agency.
019d75ddlist reports
Returns a listing of every available report type within the NinjaCat agency system.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with NinjaCat, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
You connect your AI agent straight into your NinjaCat agency account data with this server. Forget logging into the portal just to pull metrics or check statuses; your agent runs these tools instantly through natural conversation.
Agency Overview and User Info: You can get a high-level look at everything by pulling the general metadata for the entire NinjaCat agency account using get_agency_info. If you need to know who's running the show, your agent calls get_me, which immediately pulls the current user profile details attached to the server.
Client and Advertiser Management: Need a roster of everyone you manage? Run list_advertisers to get a list of every advertiser currently tied to the agency account. From that list, if you know an ID, your agent uses get_advertiser to retrieve detailed information for just one specific client.
Data Connections and Sources: You can map out your entire data setup with simple calls. Use list_data_sources to see every active marketing platform data source connected to NinjaCat. Then, run list_data_accounts to list all the individual accounts linked—you'll see if you've got Google Ads or Meta properly plugged in.
Campaign Status: To track where your ad spend is going right now, your agent uses list_agency_campaigns. This tool lists every active marketing campaign across the whole agency scope, letting you know exactly what's running.
Reporting and Metrics: The server handles all things reporting. First, run list_reports to pull a complete listing of every report type available in the NinjaCat system. Want to see if a specific report ran last week? Use get_report_history; this fetches the full execution history for any given report, giving you timestamps and success statuses.
To get the data right now, your agent calls get_report_download_url, generating a direct link that lets you download the latest generated file immediately.
How NinjaCat MCP Works
- 1 Subscribe to the server and enter your NinjaCat Agency Identifier Key, Client ID, and Client Secret.
- 2 Your AI agent uses a natural language prompt (e.g., "List all advertisers").
- 3 The agent calls the specific tool endpoint, receiving structured data like advertiser names or report URLs.
The bottom line is: you manage your entire marketing agency data directly from your chat window using API tools.
Who Is NinjaCat MCP For?
Agency managers and account teams who waste time clicking through multiple dashboards are the primary users. If you're tired of manually pulling reports, cross-referencing campaign IDs across platforms, or just want a single source of truth for all client data—this is for you.
You use the agent to quickly check report statuses or pull advertiser details without having to navigate the full NinjaCat portal.
You monitor campaign distribution and data source connectivity for multiple clients directly from your main workspace.
You automate the retrieval of historical report run logs and download links to build performance audits quickly.
What Changes When You Connect
- Stop manual logging in. Instead of navigating the NinjaCat portal to check report status, use
list_reportsorget_report_history. Your agent pulls that info instantly.
See all accounts at once. You can runlist_advertisersand get a full roster of clients immediately—no need to jump through client-specific dashboards. - Know your data connections. Use
list_data_sourcesandlist_data_accountstogether. This confirms every marketing platform (Google Ads, Facebook Ads) is linked up correctly before you start an audit. - Get the file instantly. Need last month's performance report? Don't wait for a download link—call
get_report_download_urland get the direct link right in your chat window. - Audit campaign spread. Running
list_agency_campaignslets you view all active campaigns across the whole agency, so you never miss which client is running what ad set. - Deep dive on any entity. If you have an ID and need specific details—like a client's full profile or report metadata—use
get_advertiserfor that granular lookup.
Real-World Use Cases
Audit required: Check data completeness.
An analyst needs to know if the account is connected to all necessary platforms. They ask their agent, "What sources are active?" The agent calls list_data_sources, which immediately confirms the connection status and lists available platforms (e.g., Meta Ads, GA4). This prevents starting an audit with missing data.
Client onboarding: Listing all managed accounts.
An account manager needs to verify every client in the agency for a compliance check. They use list_advertisers. The tool returns a clean list of every advertiser, allowing them to confirm coverage without manually reviewing dozens of dashboards.
Performance review: Getting historical data.
A manager needs proof of performance for Q1. They ask the agent about the 'Monthly Performance' report. The agent first uses list_reports to confirm its name, then calls get_report_history, getting a log showing every successful run date and time.
Quick check: Who is this user?
A team member needs to verify their own permissions or role within the agency. They simply ask, "Who am I?" The agent runs get_me, providing immediate access to their current user details and profile information.
The Tradeoffs
Trying to get everything in one go
Asking, "Give me all the campaign data for every advertiser's reports." This is too vague and requires multiple parameters that the agent can't guess.
→
Break it down. First, use list_advertisers to get a list of IDs. Then, loop through those IDs and call get_advertiser for each one. Finally, run list_agency_campaigns to scope the data.
Assuming reports are always ready
Asking only for 'the latest report' without checking if it was actually generated or if a download URL is available.
→
Always check first. Use list_reports to find the name, then use get_report_history to confirm it ran successfully today, and finally call get_report_download_url.
Getting stuck on data source names
Trying to remember if the tool needs 'Google Ads' or 'Google Ad Accounts' as a parameter.
→
Don't guess. Start by running list_data_sources and then list_data_accounts. This gives you the exact, required naming conventions for all subsequent calls.
When It Fits, When It Doesn't
Use this server if your workflow requires accessing structured marketing data that lives inside NinjaCat: reporting URLs, advertiser IDs, campaign names, or connection metadata. The API structure is designed to handle complex lookups—you need the list_advertisers tool before you can reliably call get_advertiser(id).
Don't use this if your goal is merely general knowledge retrieval (e.g., "What are good marketing tips?"). For those tasks, a general LLM works fine. Also, if you only need a single piece of data and know the exact ID already—and don't need to verify its existence first—you might skip listing tools. But generally, always list first (like running list_reports) before attempting a retrieval (get_report_download_url).
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by NinjaCat. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Checking report status used to mean clicking through three separate dashboards.
Before this server, checking performance meant logging into NinjaCat, finding the 'Reports' tab, selecting a client from a dropdown (and praying you picked the right one), then manually running the report and hoping it finished in time. If anything broke, you had to start over.
Now, your agent handles all of that. You ask for the status, and it runs `list_reports` or `get_report_history`. You get a clean JSON response with success/failure status and run times—no dashboard clicks needed.
NinjaCat MCP Server: Get detailed ad data instantly.
You don't have to copy-paste account IDs from a spreadsheet into the platform, wait for a manual API call, and then check a separate sheet for the download link. Those three steps are gone.
You simply tell your agent, "Give me the campaign data for Acme Corp," and it handles the `list_advertisers` lookup, the `get_advertiser` pull, and the final report retrieval—all in one turn.
Common Questions About NinjaCat MCP
How do I list all active advertisers using NinjaCat MCP Server? +
You run the list_advertisers tool. This returns a complete roster of every advertiser managed by your agency, giving you their names and basic IDs to work with.
Can I check report history with get_report_history? +
Yes. You pass the specific Report ID into get_report_history. The tool then returns a log detailing when the report ran previously, if it succeeded, and what the run date was.
What do I use list_data_accounts for? +
Use list_data_accounts to see every specific data account connected across your platforms (like Google Ads). This helps you scope exactly where your performance numbers are coming from.
Is get_advertiser the right tool for a client profile? +
Yes. If you have an advertiser's unique ID, calling get_advertiser provides a detailed, single-source view of that specific company's managed data.
How do I get the download URL for a report? +
You use the get_report_download_url tool. You must first know which report you need, and this function gives you the final direct link to the generated file.
What is the purpose of `list_data_sources`? +
It lists all active marketing platforms connected to your agency. This lets you verify every data stream, like Google Ads or Facebook Ads, that's feeding into NinjaCat.
How do I check my account setup using `get_agency_info`? +
This tool retrieves high-level settings for your entire agency. It confirms the overall structure and current permissions tied to your credentials.
If I want a full overview of ongoing efforts, what does `list_agency_campaigns` do? +
It lists every active marketing campaign managed by your agency. You can monitor performance across all campaigns without needing a specific report ID.
Where do I find my NinjaCat API credentials? +
Log in to your NinjaCat agency settings and navigate to the 'Apps' tab. There you will find your Agency Identifier Key, Client ID, and Client Secret.
Can I download a report directly through the agent? +
Yes! The get_report_download_url tool provides the direct link to the latest generated file for a specific report, allowing you to access it without opening the portal.
How do I see which data sources are connected? +
Use the list_data_sources tool to see all platforms (e.g., Google Ads, Facebook) integrated with your account, and list_data_accounts for specific account connections.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Beamer
Manage product updates and user feedback via Beamer — create posts, track analytics, and monitor feedback directly from any AI agent.
TikTok Ads
Equip your AI agent with direct access to TikTok Ads — manage campaigns, track ad performance, and optimize spend without opening TikTok Ads Manager.
Nimble CRM
Manage relationships and deals via Nimble CRM — track contacts, deals, and activities directly from your AI agent.
You might also like
Tradier
Trade equities and options, fetch real-time market data, and manage your brokerage accounts directly through any AI agent.
OptimoRoute
Optimize delivery routes via OptimoRoute — create orders, run route planning, track driver GPS, and verify proof of delivery from any AI agent.
Nearmap (High-Res Aerial Imagery & AI)
Manage geospatial data via Nearmap — retrieve high-res aerial imagery, extract AI features, and audit survey coverage.