---
title: "Skylar MCP Server Docs | Skylar | Skylar"
description: "Connect MCP clients to Skylar coaching, team structure, performance, and practice tools through the authenticated Skylar MCP server."
url: "https://www.getskylar.com/docs/mcp"
---

[Developer Portal](https://www.getskylar.com/docs)

MCP Server

# Connect AI clients to Skylar sales coaching context.

Skylar's MCP server exposes authenticated tools for team structure, performance, and recommended practice roleplays. The reference below shows the public connection details, tools, resources, and schemas available to MCP clients.

Runtime endpoint

https://app.getskylar.com/mcp

ready

**Server URL**

https://app.getskylar.com/mcp

**Transport**

streamable-http

**Auth**

oauth2 required

**Status**

ready

Connection JSON

```
{
  "serverUrl": "https://app.getskylar.com/mcp",
  "transport": {
    "type": "streamable-http",
    "url": "https://app.getskylar.com/mcp"
  },
  "auth": {
    "required": true,
    "scopes": [
      "openid",
      "profile",
      "email"
    ],
    "type": "oauth2"
  }
}
```

## Before You Connect

Use the MCP server when an AI client needs live Skylar context for coaching, reporting, or practice planning. The client must support OAuth and streamable HTTP MCP transport.

### Authentication

OAuth is required. Clients request the public scopes listed in the connection metadata.

### Access Boundary

Tool results are scoped to the Skylar workspace the authenticated user is allowed to access.

### Static Discovery

The website serves discovery JSON while the app domain serves the actual runtime MCP endpoint.

[Manifest https://app.getskylar.com/.well-known/mcp.json](https://app.getskylar.com/.well-known/mcp.json) [Server card https://app.getskylar.com/.well-known/mcp/server-card.json](https://app.getskylar.com/.well-known/mcp/server-card.json) [Protected resource metadata https://app.getskylar.com/.well-known/oauth-protected-resource](https://app.getskylar.com/.well-known/oauth-protected-resource) [Authorization server metadata https://app.getskylar.com/.well-known/oauth-authorization-server](https://app.getskylar.com/.well-known/oauth-authorization-server) [Tools JSON /docs/mcp/tools.json](https://www.getskylar.com/docs/mcp/tools.json) [Resources JSON /docs/mcp/resources.json](https://www.getskylar.com/docs/mcp/resources.json)

## Available Tools

Tool names, descriptions, schemas, annotations, and UI resource links mirror the public [MCP tools JSON](https://www.getskylar.com/docs/mcp/tools.json).

3 tools

get\_team\_structure read only

### Get Team Structure

Look up the user's Skylar team structure, including active member counts, role mix, and configured teams. Use this when the user asks what teams exist, how their Skylar team is set up, or what roles are represented. This does not return sales performance, scores, call analytics, coaching recommendations, or individual member lists.

UI resource

Skylar Team Structure

Render a compact Skylar team structure widget.

Tool annotations and public metadata are available in the [MCP tools JSON](https://www.getskylar.com/docs/mcp/tools.json) .

Input schema

```
                        {
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "orgId": {
      "description": "Optional Skylar workspace ID. Leave this blank unless Skylar asks you to choose between multiple workspaces.",
      "type": "string"
    }
  },
  "type": "object"
}
                      
```

Output schema

```
                        {
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "members": {
      "additionalProperties": false,
      "properties": {
        "active_count": {
          "minimum": 0,
          "type": "integer"
        },
        "role_counts": {
          "additionalProperties": {
            "$ref": "#/properties/members/properties/active_count"
          },
          "type": "object"
        },
        "sampled_count": {
          "$ref": "#/properties/members/properties/active_count"
        },
        "truncated": {
          "type": "boolean"
        }
      },
      "required": [
        "active_count",
        "sampled_count",
        "role_counts",
        "truncated"
      ],
      "type": "object"
    },
    "org": {
      "additionalProperties": false,
      "properties": {
        "name": {
          "type": "string"
        },
        "org_id": {
          "type": "string"
        }
      },
      "required": [
        "org_id",
        "name"
      ],
      "type": "object"
    },
    "teams": {
      "additionalProperties": false,
      "properties": {
        "count": {
          "$ref": "#/properties/members/properties/active_count"
        },
        "items": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "name": {
                "type": "string"
              },
              "team_id": {
                "type": "string"
              }
            },
            "required": [
              "team_id",
              "name"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "truncated": {
          "type": "boolean"
        }
      },
      "required": [
        "count",
        "truncated",
        "items"
      ],
      "type": "object"
    }
  },
  "required": [
    "org",
    "members",
    "teams"
  ],
  "type": "object"
}
                      
```

get\_team\_performance read only

### Get Team Performance

Summarize current-week Skylar sales practice performance for the user's organization, including total practice calls, average score, estimated practice minutes, and a limited ranked list of team members. Use this when the user asks how their team is performing, who needs coaching, who is improving, or how Skylar practice is going this week. This does not return raw call transcripts, recording URLs, or per-call detail.

UI resource

Skylar Team Performance

Render a compact current-week Skylar team performance widget.

Tool annotations and public metadata are available in the [MCP tools JSON](https://www.getskylar.com/docs/mcp/tools.json) .

Input schema

```
                        {
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "orgId": {
      "description": "Optional Skylar workspace ID. Leave this blank unless Skylar asks you to choose between multiple workspaces.",
      "type": "string"
    }
  },
  "type": "object"
}
                      
```

Output schema

```
                        {
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "org": {
      "additionalProperties": false,
      "properties": {
        "name": {
          "type": "string"
        },
        "org_id": {
          "type": "string"
        }
      },
      "required": [
        "org_id",
        "name"
      ],
      "type": "object"
    },
    "rankings": {
      "additionalProperties": false,
      "properties": {
        "items": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "average_score": {
                "$ref": "#/properties/summary/properties/average_score"
              },
              "call_count": {
                "$ref": "#/properties/summary/properties/total_calls"
              },
              "email": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "rank": {
                "$ref": "#/properties/rankings/properties/limit"
              },
              "strongest_criteria": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "rank",
              "name",
              "email",
              "call_count",
              "average_score",
              "strongest_criteria"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "limit": {
          "exclusiveMinimum": 0,
          "type": "integer"
        },
        "truncated": {
          "type": "boolean"
        }
      },
      "required": [
        "truncated",
        "limit",
        "items"
      ],
      "type": "object"
    },
    "summary": {
      "additionalProperties": false,
      "properties": {
        "active_participant_count": {
          "$ref": "#/properties/summary/properties/total_calls"
        },
        "average_score": {
          "maximum": 100,
          "minimum": 0,
          "type": "number"
        },
        "estimated_call_minutes": {
          "minimum": 0,
          "type": "number"
        },
        "total_calls": {
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "total_calls",
        "average_score",
        "estimated_call_minutes",
        "active_participant_count"
      ],
      "type": "object"
    },
    "time_range": {
      "additionalProperties": false,
      "properties": {
        "end": {
          "$ref": "#/properties/time_range/properties/start"
        },
        "preset": {
          "const": "current_week",
          "type": "string"
        },
        "start": {
          "format": "date-time",
          "type": "string"
        }
      },
      "required": [
        "preset",
        "start",
        "end"
      ],
      "type": "object"
    }
  },
  "required": [
    "org",
    "time_range",
    "summary",
    "rankings"
  ],
  "type": "object"
}
                      
```

get\_practice\_scenario\_recommendations read only

### Get Practice Scenario Recommendations

Show Skylar sales roleplay practice scenarios the user can launch to improve selling skills. Use this when the user asks what to practice, wants a sales roleplay, wants objection handling or discovery practice, or wants to start a Skylar coaching scenario. Returns scenario cards and launch URLs; it does not start a call directly.

UI resource

Skylar Practice Scenario Recommendations

Render Skylar practice scenario cards with launch links.

Tool annotations and public metadata are available in the [MCP tools JSON](https://www.getskylar.com/docs/mcp/tools.json) .

Input schema

```
                        {
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {},
  "type": "object"
}
                      
```

Output schema

```
                        {
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "scenarios": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "accent": {
            "type": "string"
          },
          "average_score": {
            "maximum": 100,
            "minimum": 0,
            "type": "number"
          },
          "description": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "image_alt": {
            "type": "string"
          },
          "image_url": {
            "type": "string"
          },
          "launch_url": {
            "type": "string"
          },
          "title": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "title",
          "description",
          "average_score",
          "image_alt",
          "image_url",
          "accent",
          "launch_url"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "scenarios"
  ],
  "type": "object"
}
                      
```

## Resources And Workflows

Resources describe MCP app UI surfaces compatible clients can render. Workflows help clients decide when each Skylar tool belongs in an assistant flow.

### Skylar Team Structure

Render a compact Skylar team structure widget.

text/html;profile=mcp-app

ui://skylar/team-structure-v1.html

### Skylar Practice Scenario Recommendations

Render Skylar practice scenario cards with launch links.

text/html;profile=mcp-app

ui://skylar/practice-scenario-recommendations-v1.html

### Skylar Team Performance

Render a compact current-week Skylar team performance widget.

text/html;profile=mcp-app

ui://skylar/team-performance-v1.html

### Inspect team setup

Use team structure when an AI client needs to understand the user's Skylar workspace, role mix, and configured teams before recommending next actions.

### Review team performance

Use performance data when a manager or coach asks which teams need attention, where practice is improving, and what trends should shape coaching work.

### Recommend practice

Use scenario recommendations when a rep or coach wants targeted practice options grounded in the team context Skylar can see.

## Agent Skill Block

Add this block to an agent's system instructions when it needs to decide how to use Skylar MCP tools.

```
You can use the Skylar MCP server for authenticated Skylar coaching context.
Use get_team_structure before making workspace-level assumptions.
Use get_team_performance when the user asks about team scores, trends, or coaching focus.
Use get_practice_scenario_recommendations when the user needs targeted sales practice.
Do not invent Skylar data. If a tool is unavailable or access is ambiguous, ask the user to connect the correct Skylar account.
```

## Important Notes

-   The website discovery files point to the app runtime at https://app.getskylar.com/mcp.
-   Tool outputs are generated only inside authenticated MCP sessions and are not stored in these public docs files.
-   The schema reference mirrors the MCP metadata advertised by the Skylar runtime server.

## Troubleshooting

### Client cannot discover the server

Start with the website manifest at [/.well-known/mcp.json](https://www.getskylar.com/.well-known/mcp.json) and confirm it advertises the app-domain MCP server URL.

### OAuth flow fails

Check that the client supports the advertised protected-resource and authorization-server metadata URLs.

### Tool returns no workspace context

Confirm the authenticated user has access to the right Skylar workspace, or select the correct workspace if the client prompts for one.

## FAQ

Does the website call the live MCP server at build time?

No. The website renders committed public MCP metadata. Production builds do not call live app services.

Does the public docs page expose customer data?

No. The public metadata describes tools, resources, schemas, and connection details only. Tool outputs require an authenticated MCP session.

Can a client discover the server from the website domain?

Yes. The website serves the static MCP manifest and server card, both advertising the app-domain runtime server URL.
