get_schema

Get the schema for "App manifest", "Declarative agent manifest", "API plugin manifest", "M365 agents yaml", use it everytime before understanding, modifying or creating any of these manifest files.

Server M365agentstoolkit @microsoft/m365agentstoolkit-mcp
Category Read
Risk class Low
Parameters 22 required

What get_schema does on M365agentstoolkit

AI agents call get_schema to retrieve information from M365agentstoolkit without modifying anything — typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.

ParameterTypeRequiredDescription
schema_name string Yes name of schema
schema_version string Yes version of schema in semantic versioning format vX.Y, where X is the major version and Y is the minor version (e.g. v1.0, v1.19, v2.1). Use "latest" if unsure.

Parameters from the server's own tool schema.

Why get_schema needs a policy

This is a read-only operation that retrieves schema definitions for manifest files. It supports human understanding and validation but does not create, modify, delete, or execute anything. The highest risk is that an AI agent might retrieve inappropriate schema context, but the tool itself performs only data retrieval with no side effects.

From the tool's definition Tool description states 'Get the schema' and 'use it everytime before understanding, modifying or creating', indicating it retrieves schema information without modifying data. No mutation, deletion, execution, or side effects are implied.

Questions about get_schema

What does the get_schema tool do? +

Get the schema for "App manifest", "Declarative agent manifest", "API plugin manifest", "M365 agents yaml", use it everytime before understanding, modifying or creating any of these manifest files. It is categorised as a Read tool in the M365agentstoolkit MCP Server, which means it retrieves data without modifying state.

What parameters does get_schema accept? +

get_schema accepts 2 parameters: schema_name, schema_version. Required: schema_name, schema_version. The full parameter table on this page comes from the server's own tool schema.

How do I enforce a policy on get_schema? +

Register the M365agentstoolkit MCP server in PolicyLayer and add a rule for get_schema: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches M365agentstoolkit. Nothing to install.

What risk level is get_schema? +

get_schema is a Read tool with low risk. Read-only tools are generally safe to allow by default.

Can I rate-limit get_schema? +

Yes. Add a rate_limit block to the get_schema rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.

How do I block get_schema completely? +

Set action: deny in the PolicyLayer policy for get_schema. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.

What MCP server provides get_schema? +

get_schema is provided by the M365agentstoolkit MCP server (@microsoft/m365agentstoolkit-mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

// LOOK UP ANOTHER SERVER

Every MCP server has a record like this.

Type a name, get the same breakdown: verified identity, auth posture, risk grade, capabilities, recommended policy.

Teams ship this data inside their own products. See what a licence covers →

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.