Developer Portal
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

Server card

https://app.getskylar.com/.well-known/mcp/server-card.json

Protected resource metadata

https://app.getskylar.com/.well-known/oauth-protected-resource

Authorization server metadata

https://app.getskylar.com/.well-known/oauth-authorization-server

Tools JSON

/docs/mcp/tools.json

Resources JSON

/docs/mcp/resources.json

Available Tools

Tool names, descriptions, schemas, annotations, and UI resource links mirror the public 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 .

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 .

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 .

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 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.