Tools

echo

Echoes back the input string

Input schema:

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Message to echo"
    }
  },
  "required": [
    "message"
  ]
}

Annotations:

{
  "title": null,
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}

get-annotated-message

Demonstrates how annotations can be used to provide metadata about content.

Input schema:

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "messageType": {
      "type": "string",
      "enum": [
        "error",
        "success",
        "debug"
      ],
      "description": "Type of message to demonstrate different annotation patterns"
    },
    "includeImage": {
      "default": false,
      "description": "Whether to include an example image",
      "type": "boolean"
    }
  },
  "required": [
    "messageType"
  ]
}

Annotations:

{
  "title": null,
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}

get-env

Returns all environment variables, helpful for debugging MCP server configuration

Input schema:

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

Annotations:

{
  "title": null,
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}

get-resource-links

Returns up to ten resource links that reference different types of resources

Input schema:

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "count": {
      "default": 3,
      "description": "Number of resource links to return (1-10)",
      "type": "number",
      "minimum": 1,
      "maximum": 10
    }
  }
}

Annotations:

{
  "title": null,
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}

get-resource-reference

Returns a resource reference that can be used by MCP clients

Input schema:

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "resourceType": {
      "default": "Text",
      "type": "string",
      "enum": [
        "Text",
        "Blob"
      ]
    },
    "resourceId": {
      "default": 1,
      "description": "ID of the text resource to fetch",
      "type": "number"
    }
  }
}

Annotations:

{
  "title": null,
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}

get-structured-content

Returns structured content along with an output schema for client data validation

Input schema:

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "location": {
      "type": "string",
      "enum": [
        "New York",
        "Chicago",
        "Los Angeles"
      ],
      "description": "Choose city"
    }
  },
  "required": [
    "location"
  ]
}

Output schema:

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "temperature": {
      "type": "number",
      "description": "Temperature in celsius"
    },
    "conditions": {
      "type": "string",
      "description": "Weather conditions description"
    },
    "humidity": {
      "type": "number",
      "description": "Humidity percentage"
    }
  },
  "required": [
    "temperature",
    "conditions",
    "humidity"
  ],
  "additionalProperties": false
}

Annotations:

{
  "title": null,
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}

get-sum

Returns the sum of two numbers

Input schema:

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "a": {
      "type": "number",
      "description": "First number"
    },
    "b": {
      "type": "number",
      "description": "Second number"
    }
  },
  "required": [
    "a",
    "b"
  ]
}

Annotations:

{
  "title": null,
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}

get-tiny-image

Returns a tiny MCP logo image.

Input schema:

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

Annotations:

{
  "title": null,
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}

gzip-file-as-resource

Compresses a single file using gzip compression. Depending upon the selected output type, returns either the compressed data as a gzipped resource or a resource link, allowing it to be downloaded in a subsequent request during the current session.

Input schema:

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "name": {
      "default": "README.md.gz",
      "type": "string",
      "description": "Name of the output file"
    },
    "data": {
      "default": "https://raw.githubusercontent.com/modelcontextprotocol/servers/refs/heads/main/README.md",
      "type": "string",
      "format": "uri",
      "description": "URL or data URI of the file content to compress"
    },
    "outputType": {
      "default": "resourceLink",
      "description": "How the resulting gzipped file should be returned. 'resourceLink' returns a link to a resource that can be read later, 'resource' returns a full resource object.",
      "type": "string",
      "enum": [
        "resourceLink",
        "resource"
      ]
    }
  }
}

Annotations:

{
  "title": null,
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": true
}

toggle-simulated-logging

Toggles simulated, random-leveled logging on or off.

Input schema:

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

Annotations:

{
  "title": null,
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": false
}

toggle-subscriber-updates

Toggles simulated resource subscription updates on or off.

Input schema:

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

Annotations:

{
  "title": null,
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": false
}

trigger-long-running-operation

Demonstrates a long running operation with progress updates.

Input schema:

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "duration": {
      "default": 10,
      "description": "Duration of the operation in seconds",
      "type": "number"
    },
    "steps": {
      "default": 5,
      "description": "Number of steps in the operation",
      "type": "number"
    }
  }
}

Annotations:

{
  "title": null,
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}

simulate-research-query

Simulates a deep research operation that gathers, analyzes, and synthesizes information. Demonstrates MCP task-based operations with progress through multiple stages. If ‘ambiguous’ is true and client supports elicitation, sends an elicitation request for clarification.

Input schema:

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "description": "The research topic to investigate"
    },
    "ambiguous": {
      "default": false,
      "description": "Simulate an ambiguous query that requires clarification (triggers input_required status)",
      "type": "boolean"
    }
  },
  "required": [
    "topic"
  ]
}

Annotations:

{
  "title": null,
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": false
}