# GlassFrog MCP

> GlassFrog MCP connects your organization's self-management data directly to any AI client. This tool lets you retrieve circle structures, role definitions, and project details instantly via natural conversation. Instead of navigating complex dashboards, you can ask questions about governance policies, check accountabilities for specific roles, or list active tactical projects in real time.

## Overview
- **Category:** human-resources
- **Price:** Free
- **Tags:** holacracy, organizational-clarity, governance, role-management, self-management

## Description

Managing a self-managed organization means keeping track of who does what, which policies apply, and where the current work effort is focused—it’s a lot of moving pieces. This MCP connects GlassFrog to your agent, pulling all that operational data into a conversational interface. You can ask about circle structures or request full role definitions without ever leaving your chat window. Need to know if someone has the right permissions? Simply ask your AI client to check member records by email. Want to start tracking something new? Use the capability to programmatically create projects within specific circles. This gives you a clear view of governance and current performance metrics, letting you automate complex tasks using Vinkius' catalog of tools.

## Tools

### verify_api_connection
Checks if your credentials are properly connected to the GlassFrog API.

### create_new_project
Adds a new tactical project record into the system.

### find_member_by_email
Searches for and verifies an organization member using their email address.

### get_circle_summary
Retrieves a high-level overview of a specific organizational circle's details.

### list_role_assignments
Retrieves a list detailing who has been assigned which roles within the company.

### list_checklist_items
Lists all defined checklists for tracking progress on initiatives.

### list_holacracy_circles
Lists every active organizational circle in the system.

### list_circle_metrics
Retrieves the currently defined operational metrics used to track circle health.

### list_org_members
Lists every person currently registered in the organization's member directory.

### list_circle_policies
Fetches all governing policies and rules applicable to a specific circle.

### list_tactical_projects
Lists every current and past tactical project in the organization.

### list_holacracy_roles
Retrieves a list of all defined role types and their purposes across the organization.

## Prompt Examples

**Prompt:** 
```
List all active circles in my organization.
```

**Response:** 
```
Retrieving circles... I found 5 active circles, including 'General Circle' (ID: 1), 'Engineering', and 'Marketing'. Would you like the roles for any of them?
```

**Prompt:** 
```
What are the accountabilities for the 'Product Manager' role?
```

**Response:** 
```
Fetching role details... The Product Manager role (Circle: Engineering) has 3 accountabilities: 1. Defining product strategy, 2. Prioritizing the roadmap, 3. Gathering user feedback.
```

**Prompt:** 
```
Show me the current tactical metrics for the 'Marketing' circle (ID: 123).
```

**Response:** 
```
Retrieving metrics... For the Marketing circle, I found 2 active metrics: 'Monthly Active Users' and 'Ad Spend Efficiency'. Both were last updated 2 days ago.
```

## Capabilities

### Understand Organizational Structure
List all active organizational circles and retrieve detailed descriptions for every defined role.

### Track Performance and Policy
View current metrics, checklist items, and specific governance policies affecting any circle.

### Manage Projects and Roles
List existing tactical projects or create brand new ones directly through your agent's chat interface.

### Verify Personnel Data
Search the member database by email to confirm an individual’s role assignments and current status.

## Use Cases

### Onboarding a New Team Member
A new Ops Manager needs to know what policies govern their department. Instead of reading a 40-page manual, they ask their agent: 'What are the policies for Engineering?' The agent uses `list_circle_policies` and instantly replies with the relevant rules.

### Identifying Role Gaps
A team lead suspects a role is under-assigned. They ask their agent to compare who *should* have certain roles against reality, using `list_role_assignments` and cross-referencing it with the full list of available roles via `list_holacracy_roles`.

### Quarterly Review Preparation
An Operations Manager needs to report on all active work streams. They prompt their agent for a summary of all ongoing initiatives, triggering the retrieval of data from `list_tactical_projects` and key metrics via `list_circle_metrics`.

### Verifying User Access
A manager needs to verify if an employee was correctly assigned a role after a department restructure. They use `find_member_by_email` followed by checking the results of `list_role_assignments` for immediate confirmation.

## Benefits

- Stop manually checking role assignments. Use `list_role_assignments` to instantly confirm who is accountable for what, every time.
- Get an instant organizational health check by calling `list_circle_metrics`, providing a high-level view of key performance indicators without dashboard navigation.
- When you need clarity on rules, use `list_circle_policies` to retrieve all governing documents and constraints in minutes, not hours.
- Never start from scratch. Use `create_new_project` directly through your agent when a new initiative needs tracking, linking it immediately to the correct circle.
- Need to know who's on the team? Running `list_holacracy_circles` gives you the full map of every unit in the organization instantly.

## How It Works

The bottom line is you talk to your agent naturally, and it handles the complex API calls behind the scenes.

1. Subscribe to this MCP via Vinkius Marketplace and enter your GlassFrog API Key.
2. Select your preferred AI client (Claude, Cursor, Windsurf, etc.) and connect it to the catalog.
3. Start asking questions in plain language; your agent will invoke the necessary tools to fetch structured data.

## Frequently Asked Questions

**How do I get an API Key for GlassFrog?**
Log in to your GlassFrog account, click on your profile avatar, go to 'Settings', and then 'API Keys' to generate or copy your token.

**What is a Circle in GlassFrog?**
A Circle is an organizational unit in Holacracy that groups together related roles and responsibilities to achieve a specific purpose.

**Can I create new projects via the agent?**
Yes! Use the 'create_new_project' tool. You will need to provide a description and the ID of the Circle where the project should be added.

**How do I find a Circle ID?**
Use the 'list_holacracy_circles' tool. The agent will return all available circles along with their unique IDs and names.

**What specific details does the `list_holacracy_roles` tool provide?**
It returns comprehensive role definitions. You get detailed accountabilities for every listed role, showing exactly who is responsible for what within the organization.

**How does the `find_member_by_email` tool help with role verification?**
The tool searches for a member using their unique email address. Once found, you can use other tools to verify or list all of that person's current role assignments.

**Can I use `list_circle_policies` to understand organizational rules?**
Yes, this tool retrieves the official policies and governance records for a specific circle. It helps you quickly understand the constraints and rules governing that part of your organization.

**What does running `verify_api_connection` confirm about my setup?**
It confirms that your API key is valid and active. Running this tool tests your connection to GlassFrog, ensuring you have the proper permissions without making any changes.