# Range MCP

> Range MCP Server connects your AI agent to Range.co. It lets you manage team communication by retrieving user profiles, listing active teams, checking individual updates (snippets), and monitoring organizational goals directly in chat. Stop manually reading status reports; ask your agent for the latest objectives or daily check-ins.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** async-check-ins, team-sync, objective-tracking, remote-work, meeting-tools

## Description

**Range MCP Server - Sync Team Status & Objectives**

Your agent connects directly to Range.co, giving you full visibility into team status and company goals right inside your chat client. You'll stop having to read through dozens of daily reports; instead, you just ask for what you need.

### Managing People and Teams

You can get a complete roster of every user account in the organization’s directory using `list_users`. If you need specific profile data on one person, `get_user` pulls all available metadata by name or ID. To map out your workspace structure, `list_teams` returns a list of every team set up within Range. When you select a single group, `get_team` fetches all the detailed metadata for that specified workspace team.

### Tracking Status and Check-ins

This server lets you monitor what’s happening day-to-day. You can pull a list of every historical and current team check-in update using `list_updates`, filtering those results by user or target group to narrow the focus. To see the general details of any specific status record, call `get_update`. For deep context, `get_snippet` pulls the full, detailed content from one single check-in update for review. You also can post a new standup update record for the team using `create_update`.

### Monitoring Goals and Objectives

Keeping track of where you're headed is simple. Use `list_goals` to retrieve every high-level strategic goal defined across the organization. For current targets, `list_objectives` lists all active, tracked organizational objectives. When you need deep metrics on one specific objective, `get_objective` retrieves all details and the current status for that single target.

## Tools

### create_update
Posts a new standup update record for the team.

### get_objective
Retrieves all details and current status metrics for one specified organizational objective.

### get_snippet
Pulls the full, detailed content of a specific check-in update snippet.

### get_team
Fetches all details and metadata about one specified workspace team.

### get_update
Retrieves the general details of a specific check-in update record.

### get_user
Gets all available profile data and metadata for one specific team member.

### list_goals
Retrieves a list of every high-level strategic goal defined across the organization.

### list_objectives
Lists all active, tracked organizational objectives in the workspace.

### list_teams
Returns a comprehensive list of every team currently set up in your Range workspace.

### list_updates
Lists all historical and current team check-in updates, letting you filter by user or target group.

### list_users
Provides a complete list of every user account registered in the organization's directory.

## Prompt Examples

**Prompt:** 
```
List all teams in my Range workspace.
```

**Response:** 
```
I've retrieved your teams. You have 3 active groups: 'Product Team', 'Infrastructure', and 'Marketing Hub'. Which one would you like to see member updates for?
```

**Prompt:** 
```
Show me all team standup updates from today with their mood indicators and blockers.
```

**Response:** 
```
8 of 12 team members posted updates today. Mood average: 3.8/5 (good). Highlights: Sarah completed the API redesign (3 objectives linked). James shipped the mobile notification feature. 3 blockers reported: "Waiting on design assets" (Alex, 2 days blocked), "Staging environment down" (Lisa, since morning), "Third-party API rate limit" (Mike, intermittent). 4 team members have not posted yet. Yesterday's unresolved blockers: 1 resolved, 2 carried over.
```

**Prompt:** 
```
Show me the progress on all team objectives for this quarter with completion percentages.
```

**Response:** 
```
5 team objectives for Q2. "Launch Mobile App v2" at 78% (on track, 6 of 8 milestones complete). "Reduce Customer Churn" at 65% (slightly behind, churn down from 5.2% to 4.1%, target: 3.5%). "API Response Time < 200ms" at 92% (ahead of schedule, current avg: 187ms). "Onboard 50 Enterprise Clients" at 56% (28 onboarded, pace needs acceleration). "Complete SOC 2 Certification" at 85% (final audit scheduled May 28). Overall Q2 objective health: 75.2%.
```

## Capabilities

### List Teams
Retrieves a list of all managed teams within your Range workspace.

### Get User Details
Pulls specific profile metadata for any individual team member by name or ID.

### List Updates (Check-ins)
Retrieves a list of all recorded team check-in updates, optionally filtering results by target team or user ID.

### Get Specific Objective Status
Fetches the detailed status and progress metrics for one specific organizational objective.

### List All Goals & Objectives
Lists all active team goals or lists every defined organizational objective in the workspace.

### Get Check-in Snippet Content
Retrieves the specific, detailed content (snippet) from a single check-in update for review.

## Use Cases

### The Quarterly Goal Review
A Product Lead needs to report progress on Q3 goals. Instead of manually gathering status reports, they ask their agent: 'What's the status of our top 5 objectives?' The agent uses `list_objectives` and then calls `get_objective` multiple times, returning a single, structured summary showing completion percentages.

### The Morning Sync
An Engineering Manager needs to know who is blocked. They ask: 'What are the blockers from yesterday?' The agent runs `list_updates`, filters for the most recent entries, and uses `get_snippet` on those results to pull out specific blockage reports and assignees.

### Onboarding a New Team
An Operations Team Member needs to know which teams exist and who is on them. They ask: 'List all our active departments.' The agent uses `list_teams` first, then for each team name, it calls `get_team` to give the full departmental structure.

### Checking User Status
A Project Lead needs to verify a teammate's role before assigning tasks. They ask: 'Who is on the Infrastructure team and what are their titles?' The agent uses `list_teams` to confirm the group, then calls `get_user` for each member in that list.

## Benefits

- Manage check-ins instantly. Instead of manually reading daily status reports, use the `list_updates` tool to pull a list of all recent check-ins, then call `get_snippet` on any entry for the full context.
- Keep objectives front and center. The `list_objectives` tool gives you an overview of every major goal, and `get_objective` lets your agent tell you exactly how far along each one is—no spreadsheet required.
- Audit team structure fast. Use `list_teams` to see all active groups in the workspace. Then call `get_team` to retrieve detailed metadata for any single group.
- Get employee context immediately. When reviewing an update, you can use `get_user` to pull a teammate's profile details without having to search HR systems or switch apps.
- Automate status reporting. Your agent handles the sequence: list users -> get team -> list updates -> summarizing all that data into one clean response for your review.

## How It Works

The bottom line is: your AI client handles the sequence of API calls; you just talk to it.

1. Subscribe to this server on Vinkius and enter your Range API Key in the settings.
2. Tell your AI client what you need—for example, 'Show me all updates for the Product Team.'
3. The agent uses `list_updates` and then calls specific functions (like `get_user` or `get_snippet`) to build a complete, natural language response.

## Frequently Asked Questions

**How do I list all teams using the list_teams tool?**
You simply ask your agent to 'List all my teams.' The agent executes `list_teams` and provides a clean, actionable list of every managed workspace group in your account.

**Can I get objective details using the get_objective tool?**
Yes. You give it the goal name, and the agent uses `get_objective` to pull not just the description, but also the current progress percentage against the defined metrics.

**How does list_updates help me with old reports?**
`list_updates` gives you a full chronological list of every check-in. You can then use `get_snippet` on any specific entry to retrieve the exact content that was posted at that time.

**Do I need get_user to know who is working?**
No, not always. But if you want a user's full profile details—like their role or specific metadata—you must use `get_user` after finding the person via other tools.

**When I use the list_objectives tool, how can I sort or filter the returned team goals?**
You specify filtering parameters within the function call. For example, you can narrow results by a specific organizational quarter or assign it to only show active objectives. The API accepts multiple criteria for precise data retrieval.

**If I run into an error when calling create_update, what's the most common cause?**
Usually, the issue is either invalid authentication or insufficient permissions on the target workspace. Double-check that your API key has write access and that you are passing a valid `target_id` for the update.

**What happens if I try to call list_updates repeatedly in quick succession?**
The system imposes rate limits to prevent abuse. If you exceed the allowed calls, your agent will receive an HTTP 429 error. For bulk operations, implement a small delay or batch requests into fewer calls.

**What specific details does get_team provide beyond just the team name?**
The `get_team` tool returns detailed metadata, including current membership count, associated manager ID, and the date the team was created. This helps you understand the structure of your remote units.

**Can my AI automatically find the recent check-ins for a specific user?**
Yes! Use the `list_updates` tool with the `for_user_id` parameter. Your agent will respond with the most recent check-in snippets and status updates in seconds.

**How do I find my Range API Key?**
Log in to Range, go to **Settings** > **Developer Settings** > **API Keys**, and generate a new key for your account.

**Can I see team objectives via the AI?**
Yes, use the `list_objectives` tool to retrieve all active goals and targets configured in your Range workspace.