Tools

greet

Greet the caller with a quintessential Hello World message.

Input schema:

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "The optional name to be greeted."
    }
  }
}

Output schema:

{
  "properties": {
    "result": {
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "type": "object",
  "x-fastmcp-wrap-result": true
}

Annotations:

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

Metadata:

{
  "fastmcp": {
    "tags": [
      "example",
      "greeting"
    ]
  }
}

generate_password

Generate a random password with specified length, optionally including special characters.

Input schema:

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "length": {
      "default": 12,
      "description": "The length of the password to generate (between 8 and 64 characters).",
      "maximum": 64,
      "minimum": 8,
      "type": "integer"
    },
    "use_special_chars": {
      "default": false,
      "description": "Include special characters in the password.",
      "type": "boolean"
    }
  }
}

Annotations:

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

Metadata:

{
  "fastmcp": {
    "tags": [
      "example",
      "password-generation"
    ]
  }
}

text_web_search

Perform a text web search using the provided query using DDGS.

Input schema:

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "query": {
      "description": "The search query to fetch results for. It should be a non-empty string.",
      "type": "string"
    },
    "region": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": "uk-en",
      "description": "Optional region to search in."
    },
    "max_results": {
      "anyOf": [
        {
          "maximum": 100,
          "minimum": 1,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": 10,
      "description": "The maximum number of results to return. Default is 10, maximum is 100."
    },
    "pages": {
      "anyOf": [
        {
          "maximum": 10,
          "minimum": 1,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": 1,
      "description": "The number of pages to fetch. Default is 1, maximum is 10."
    }
  },
  "required": [
    "query"
  ]
}

Output schema:

{
  "properties": {
    "result": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "result"
  ],
  "type": "object",
  "x-fastmcp-wrap-result": true
}

Metadata:

{
  "fastmcp": {
    "tags": [
      "meta-search",
      "searchexample",
      "text-search"
    ]
  }
}

permutations

Calculate the number of ways to choose k items from n items without repetition and with order.

Input schema:

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "n": {
      "description": "The number of items to choose from.",
      "minimum": 1,
      "type": "integer"
    },
    "k": {
      "anyOf": [
        {
          "minimum": 1,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "The optional number of items to choose."
    }
  },
  "required": [
    "n"
  ]
}

Output schema:

{
  "properties": {
    "result": {
      "type": "integer"
    }
  },
  "required": [
    "result"
  ],
  "type": "object",
  "x-fastmcp-wrap-result": true
}

Annotations:

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

Metadata:

{
  "fastmcp": {
    "tags": [
      "example",
      "math",
      "permutation"
    ]
  }
}

run_python_code

Run the given Python code and return the output or error message.

Input schema:

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "code": {
      "type": "string"
    },
    "inputs": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "script_name": {
      "default": "main.py",
      "type": "string"
    },
    "check_types": {
      "default": true,
      "type": "boolean"
    },
    "type_definitions": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "code"
  ]
}

Metadata:

{
  "fastmcp": {
    "tags": [
      "example",
      "monty",
      "python",
      "secure interpreter"
    ]
  }
}