# journy.io MCP MCP

> journy.io MCP manages SaaS growth data for your AI agent. It lets you list users, track events like 'Plan Upgraded', get account health scores, and analyze defined audience segments. Use this MCP when you need deep customer intelligence to automate success or marketing campaigns.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** saas-growth, customer-intelligence, event-tracking, audience-segmentation, customer-success

## Description

Need to know how a specific user is performing in your SaaS product? This MCP connects your AI agent directly to journy.io's growth platform. You can retrieve detailed information on any single account, see every event that happened—like when a user logged in or upgraded their plan—and check which segments they belong to. It’s built for teams automating customer success and growth marketing workflows. Instead of relying on multiple dashboards, your agent pulls together the full picture: who is using the product, how healthy is the associated company account, and what goals are they working toward? You access this powerful data layer through Vinkius, giving any MCP-compatible client the intelligence needed to make real-time decisions about user retention or feature adoption. It's all about turning raw usage logs into actionable customer insights.

## Tools

### get_account
Retrieves the status and key details for a specific business account.

### get_me
Verifies your own API identity credentials for system authentication checks.

### get_user
Pulls detailed intelligence on a single user, including their event history and custom properties.

### list_accounts
Lists all companies tracked in journy.io to give a high-level view of the customer base.

### list_campaigns
Lists all marketing campaigns that are currently being tracked by the platform.

### list_events
Provides a list of every user interaction or system event captured on the platform.

### list_goals
Lists all configured growth goals, like activation or retention targets for tracking progress.

### list_properties
Shows all available metadata fields for users and accounts (e.g., 'industry' or 'setup_wizard_completed').

### list_segments
Lists defined audience groups, helping you identify specific cohorts for action.

### list_users
Returns a list of all tracked users, including their names and current health scores.

## Prompt Examples

**Prompt:** 
```
List all active users in journy.io.
```

**Response:** 
```
I'll fetch the list of users currently tracked in your journy.io account.
```

**Prompt:** 
```
Show me the details for account ID '456'.
```

**Response:** 
```
I'll retrieve the full profile and health metrics for that specific account.
```

**Prompt:** 
```
Check recent tracked events.
```

**Response:** 
```
I'll look up the latest interactions and events captured by journy.io.
```

## Capabilities

### Assess Business Account Health
Get a specific account’s current status and lifecycle details.

### Gather Deep User Profiles
Pull detailed intelligence on any user, including their event history and custom properties.

### Map Customer Behaviors
List every tracked event to understand how users interact with the product.

### Analyze User Groups
Identify defined audience segments, like 'High Churn Risk' or 'Power Users', for targeted actions.

### Track Company Metrics
List all tracked accounts to get a high-level overview of the customer base health.

## Use Cases

### Determining a User’s Status Before a Call
A CSM needs to call a client but isn't sure if they should talk about product adoption or billing. They ask their agent to run `get_user` for the specific user ID, which returns recent events and properties. The AI then informs them that the user recently triggered 'Plan Upgraded', so the conversation must focus on maximizing value from the new plan.

### Finding Users At Risk of Churn
A Growth Manager needs to find everyone who hasn't logged in recently. They ask their agent to run `list_users` and filter by health score, then use that list to create a targeted re-engagement campaign.

### Auditing Business Health Post-Sale
A Sales Ops team needs to check if all company accounts are set up correctly. They ask the agent to run `list_accounts` and then use `get_account` on specific IDs to verify that necessary properties, like 'setup_wizard_completed', have been filled out.

### Analyzing Campaign ROI
The marketing team wants to know which campaigns drove the best users. They ask the agent to list all `list_campaigns` and correlate that data with the overall growth goals found via `list_goals`.

## Benefits

- Know the full story on any customer, not just surface-level data. Use `get_user` to get a deep dive into one person's activity, pulling together their event history and custom properties.
- Stop guessing which campaigns work. Run `list_campaigns` to analyze which marketing efforts are actually driving high-value users and achieving the stated growth goals (`list_goals`).
- Quickly identify who needs attention. Use `list_users` combined with account health scores to prioritize outreach, focusing only on key individuals or accounts.
- Segmenting is easier than it sounds. Call `list_segments` to find groups like 'Power Users' and target your campaigns precisely, instead of sending generic messages.
- Understand the data structure first. Use `list_properties` if you aren't sure what metadata fields are available for users or accounts; this tells you exactly what information can be gathered.

## How It Works

The bottom line is, your AI client aggregates complex SaaS data into simple, targeted inputs for automation.

1. Your agent first runs `list_users` to identify the IDs of key individuals you want to investigate.
2. Next, it uses the specific user ID with `get_user` to pull their full profile—this includes event history and custom properties.
3. Finally, if you need a broader view, it can call `list_segments` or `list_accounts` to contextualize that individual within the larger customer base.

## Frequently Asked Questions

**How do I find out what kind of data points are available for users?**
Run the `list_properties` tool. This shows every piece of metadata that can be attached to a user or account, letting you know exactly what information is trackable.

**What is the best way to check if an entire company has been set up correctly?**
Use `list_accounts` first. Then, call `get_account` on specific IDs; this gives you the full health metrics required to confirm setup completion.

**Can I track what users are doing without listing every single event?**
Yes. Run `list_users` to get a list of active individuals, and then use that data with `get_user` for an immediate history summary on the key people.

**What if I want to target only 'Power Users'?**
You run `list_segments`. This tool lists all defined audience groups, and you can then filter your actions based on those specific segment names.

**How do I verify my connection and permissions using the `get_me` tool?**
It immediately verifies your credentials. The tool returns a detailed JSON payload confirming your authenticated identity and API access scope, letting you know exactly what data your agent can interact with.

**If I run `list_users` for thousands of records, will there be rate limits?**
No, the MCP manages rate limiting automatically. It handles pagination behind the scenes, returning data in manageable chunks so your agent can process large user bases without hitting any hard quotas.

**When I use `get_user`, does it provide a comprehensive view of customer history?**
Yes. The tool pulls together custom properties, event history summaries, and account associations into one call. This gives your agent deep context on the user's journey before any action is taken.

**What data can I retrieve by running `list_campaigns`?**
You get a list of all tracked marketing campaigns. This allows your agent to pull campaign identifiers and names, which you can then cross-reference with user activity to see what drove high-value signups.

**How do I get journy.io API credentials?**
Log in to your journy.io account, navigate to Settings > API, and find your API Key.

**Can I see user properties?**
Yes, the list_properties and get_user tools allow you to retrieve all data points associated with your tracked users.

**Does it support event tracking?**
Yes, you can list tracked events using the list_events tool to monitor user interactions.