Meetly agent reference

get_meetly_usage_guide

Read-only · get_meetly_usage_guide

Read Meetly setup help, connection recovery information, available meeting workflows, and the authorized user's saved preferences and revision.

Inputs

NameTypeRequiredDescription
skill_keysarray of stringNoOmit for the two core bodies; [] for guide and index only; select keys for complete specialist instructions and references.

What you get

guide
The guide returned for your agent.
cloudAccess
cloud Access returned by this tool.Includes: connected, readAllowed, contextWriteAllowed, source, indexCoverage, cloudSummaryRequired, cloudSummaryEnabled.
connectionInstructions
connection Instructions returned by this tool.
userPreferences
user Preferences returned by this tool.Includes: profile, revision, capabilities, requiredScopes.
preferenceStatus
preference Status returned by this tool.
preferenceInstructions
preference Instructions returned by this tool.
More response fields
currency
Which release checks were completed.
distributionError
distribution Error returned by this tool.
sourceTools
source Tools returned by this tool.
workflows
workflows returned by this tool.Includes: name, activation, useWhen, instructions, files.

Example

Load the current Guide and account access status. Select skill keys only when the relevant workflow is needed.

Call get_meetly_usage_guide with:

{
  "skill_keys": []
}

Illustrative input, checked against this catalog at build time.

Full description from the catalog

Read Meetly setup help, connection recovery information, available meeting workflows, and the authorized user's saved preferences and revision. Useful when getting started, choosing a meeting workflow, or reading the profile before a confirmed preference update. Optional skill_keys selects detailed workflow documentation returned in this response. Does not save preferences, install skills, create schedules, or send messages.

Input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "skill_keys": {
      "type": "array",
      "maxItems": 7,
      "uniqueItems": true,
      "items": {
        "type": "string",
        "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
        "maxLength": 64
      },
      "description": "Omit for the two core bodies; [] for guide and index only; select keys for complete specialist instructions and references."
    }
  }
}
Output schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "guide": {
      "type": "string"
    },
    "cloudAccess": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "connected": {
          "type": "boolean"
        },
        "readAllowed": {
          "type": "boolean"
        },
        "contextWriteAllowed": {
          "type": "boolean"
        },
        "source": {
          "const": "private_cloudkit"
        },
        "indexCoverage": {
          "const": "not_verified_complete"
        },
        "cloudSummaryRequired": {
          "const": false
        },
        "cloudSummaryEnabled": {
          "type": "null"
        }
      },
      "required": [
        "connected",
        "readAllowed",
        "contextWriteAllowed",
        "source",
        "indexCoverage",
        "cloudSummaryRequired",
        "cloudSummaryEnabled"
      ]
    },
    "connectionInstructions": {
      "type": "string"
    },
    "userPreferences": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "profile": {
          "anyOf": [
            {
              "type": "object",
              "maxProperties": 64,
              "propertyNames": {
                "pattern": "^[a-z][A-Za-z0-9._-]{0,63}$"
              },
              "additionalProperties": {
                "type": "string",
                "maxLength": 2000
              },
              "description": "User-approved preference notes only; up to 64 forward-compatible fields and 8192 UTF-8 JSON bytes. Field names start with a lowercase letter and contain only letters, digits, dot, underscore or hyphen. Intended for preference notes, not secrets, transcripts, host memory or unrelated documents. Schedule notes are preferences, not a scheduler."
            },
            {
              "type": "null"
            }
          ]
        },
        "revision": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "capabilities": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "read": {
              "type": "boolean"
            },
            "write": {
              "type": "boolean"
            }
          },
          "required": [
            "read",
            "write"
          ]
        },
        "requiredScopes": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "profile",
        "revision",
        "capabilities",
        "requiredScopes"
      ]
    },
    "preferenceStatus": {
      "type": "string",
      "enum": [
        "ready",
        "scope_required",
        "native_migration_required",
        "unavailable"
      ]
    },
    "preferenceInstructions": {
      "type": "string"
    },
    "currency": {
      "type": "string",
      "enum": [
        "verified",
        "unchecked"
      ]
    },
    "distributionError": {
      "type": "string"
    },
    "sourceTools": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "search",
          "fetch",
          "list_meetings",
          "get_transcript",
          "get_summary"
        ]
      }
    },
    "workflows": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "name": {
            "type": "string"
          },
          "activation": {
            "type": "string",
            "enum": [
              "default",
              "explicit"
            ]
          },
          "useWhen": {
            "type": "string"
          },
          "instructions": {
            "type": "string"
          },
          "files": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "path": {
                  "type": "string"
                },
                "text": {
                  "type": "string"
                }
              },
              "required": [
                "path",
                "text"
              ]
            }
          }
        },
        "required": [
          "name",
          "activation",
          "useWhen",
          "instructions"
        ]
      }
    }
  },
  "required": [
    "guide",
    "sourceTools",
    "workflows"
  ]
}
Full tool definition and annotations
{
  "name": "get_meetly_usage_guide",
  "title": "Get Meetly setup and preferences",
  "description": "Read Meetly setup help, connection recovery information, available meeting workflows, and the authorized user's saved preferences and revision. Useful when getting started, choosing a meeting workflow, or reading the profile before a confirmed preference update. Optional skill_keys selects detailed workflow documentation returned in this response. Does not save preferences, install skills, create schedules, or send messages.",
  "annotations": {
    "readOnlyHint": true,
    "destructiveHint": false,
    "openWorldHint": false,
    "idempotentHint": true,
    "title": "Get Meetly setup and preferences"
  },
  "securitySchemes": [
    {
      "type": "oauth2",
      "scopes": [
        "meetings:read"
      ]
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "oauth2",
        "scopes": [
          "meetings:read"
        ]
      }
    ],
    "openai/toolInvocation/invoking": "Loading Meetly workflows…",
    "openai/toolInvocation/invoked": "Meetly workflows ready"
  },
  "inputSchema": {
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "skill_keys": {
        "type": "array",
        "maxItems": 7,
        "uniqueItems": true,
        "items": {
          "type": "string",
          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
          "maxLength": 64
        },
        "description": "Omit for the two core bodies; [] for guide and index only; select keys for complete specialist instructions and references."
      }
    }
  },
  "outputSchema": {
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "guide": {
        "type": "string"
      },
      "cloudAccess": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "connected": {
            "type": "boolean"
          },
          "readAllowed": {
            "type": "boolean"
          },
          "contextWriteAllowed": {
            "type": "boolean"
          },
          "source": {
            "const": "private_cloudkit"
          },
          "indexCoverage": {
            "const": "not_verified_complete"
          },
          "cloudSummaryRequired": {
            "const": false
          },
          "cloudSummaryEnabled": {
            "type": "null"
          }
        },
        "required": [
          "connected",
          "readAllowed",
          "contextWriteAllowed",
          "source",
          "indexCoverage",
          "cloudSummaryRequired",
          "cloudSummaryEnabled"
        ]
      },
      "connectionInstructions": {
        "type": "string"
      },
      "userPreferences": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "profile": {
            "anyOf": [
              {
                "type": "object",
                "maxProperties": 64,
                "propertyNames": {
                  "pattern": "^[a-z][A-Za-z0-9._-]{0,63}$"
                },
                "additionalProperties": {
                  "type": "string",
                  "maxLength": 2000
                },
                "description": "User-approved preference notes only; up to 64 forward-compatible fields and 8192 UTF-8 JSON bytes. Field names start with a lowercase letter and contain only letters, digits, dot, underscore or hyphen. Intended for preference notes, not secrets, transcripts, host memory or unrelated documents. Schedule notes are preferences, not a scheduler."
              },
              {
                "type": "null"
              }
            ]
          },
          "revision": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "capabilities": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "read": {
                "type": "boolean"
              },
              "write": {
                "type": "boolean"
              }
            },
            "required": [
              "read",
              "write"
            ]
          },
          "requiredScopes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "profile",
          "revision",
          "capabilities",
          "requiredScopes"
        ]
      },
      "preferenceStatus": {
        "type": "string",
        "enum": [
          "ready",
          "scope_required",
          "native_migration_required",
          "unavailable"
        ]
      },
      "preferenceInstructions": {
        "type": "string"
      },
      "currency": {
        "type": "string",
        "enum": [
          "verified",
          "unchecked"
        ]
      },
      "distributionError": {
        "type": "string"
      },
      "sourceTools": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "search",
            "fetch",
            "list_meetings",
            "get_transcript",
            "get_summary"
          ]
        }
      },
      "workflows": {
        "type": "array",
        "items": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "name": {
              "type": "string"
            },
            "activation": {
              "type": "string",
              "enum": [
                "default",
                "explicit"
              ]
            },
            "useWhen": {
              "type": "string"
            },
            "instructions": {
              "type": "string"
            },
            "files": {
              "type": "array",
              "items": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "path": {
                    "type": "string"
                  },
                  "text": {
                    "type": "string"
                  }
                },
                "required": [
                  "path",
                  "text"
                ]
              }
            }
          },
          "required": [
            "name",
            "activation",
            "useWhen",
            "instructions"
          ]
        }
      }
    },
    "required": [
      "guide",
      "sourceTools",
      "workflows"
    ]
  }
}

Server 0.17.0 · Source commit 6cc62bc5b29fb3bf09648dc755c8f5a26ea54d18

← All tools