RichStokoe.AgentTools 2.0.1

RichStokoe.AgentTools

A collection of ready-made tools for AI agents built with Microsoft Agent Framework (MAF). Drop them into any MAF agent to give it real-world capabilities without writing boilerplate.

Installation

dotnet add package RichStokoe.AgentTools

Usage

Register ToolManager in your DI container and pass its tools to your agent:

// SetupServices.cs
builder.Services.AddSingleton<ToolManager>();

// Agent/AgentRunner.cs
public class AgentRunner(IChatClient chatClient, ToolManager toolManager)
{
    private readonly AIAgent _agent = chatClient.AsAIAgent(
        name: "MyAgent",
        instructions: "You are a helpful assistant.",
        tools: toolManager.GetTools(typeFilter: AgentToolTypes.ReadWrite)
    );
}

ToolManager discovers tools at runtime by scanning all assemblies loaded into the current AssemblyLoadContext. Any public static method decorated with [AgentTool] (and [Description]) is registered as an AIFunction.

Filtering tools

GetTools accepts optional filters so you can pass only a relevant subset to an agent:

// All read-only tools
toolManager.GetTools(typeFilter: AgentToolTypes.Read)

// Read and write tools (excludes Dangerous) — convenience composite
toolManager.GetTools(typeFilter: AgentToolTypes.ReadWrite)

// Explicitly include Dangerous tools (e.g. BashTool)
toolManager.GetTools(typeFilter: AgentToolTypes.ReadWrite | AgentToolTypes.Dangerous)

// Every tool in every category — convenience composite
toolManager.GetTools(typeFilter: AgentToolTypes.All)

// All tools whose name contains "Weather" (case-insensitive)
toolManager.GetTools(namePattern: "*Weather*", typeFilter: AgentToolTypes.Read)

// Tools whose name starts with "Get", restricted to read-only
toolManager.GetTools(namePattern: "Get_*", typeFilter: AgentToolTypes.Read)

namePattern supports * (any sequence of characters) and ? (any single character) wildcards. The pattern is matched against the tool's Name if one was set on the attribute, otherwise against the method name.

typeFilter is a required opt-in — passing AgentToolTypes.None (the default) returns an empty list. This prevents accidentally handing a dangerous tool to an agent that does not need it. Use AgentToolTypes.ReadWrite for the common case of read/write tools without dangerous ones, or AgentToolTypes.All to include everything.

Tools

Utils

DateTimeTools

Gives the agent awareness of the current local date and time. Instructs the model not to cache these values, so repeated calls always return fresh results.

WeatherTools

Fetches live weather data via wttr.in. No API key required.

LocationTools

Resolves an IP address to a geographic location via ip-api.com (free for non-commercial use, no API key required). Pair with NetworkTools so the agent can look up the user's own location.

NetworkTools

MathTools

BashTool

Executes shell commands and returns stdout, stderr, and the exit code. Uses zsh on macOS/Linux and cmd.exe on Windows. Commands time out after 60 seconds.

Classified Dangerous — not returned by GetTools unless AgentToolTypes.Dangerous is included in the type filter.

FileTools

Reads and writes files on the local filesystem. Parent directories are created automatically on write. Not tagged with [AgentTool] — register manually or add the attribute to enable ToolManager discovery.

Web

WebFetchTool

Fetches the content of a URL via HTTP GET. For HTML pages, <script> and <style> blocks are removed entirely before tags are stripped, returning clean plain text. Non-2xx responses are returned as an error message. Not tagged with [AgentTool] — register manually or add the attribute to enable ToolManager discovery.

WebSearchTools

Searches the web via DuckDuckGo without an API key.

RssFeedTools

Reads and searches RSS/Atom feeds. Supports both arbitrary feed URLs and a set of named news sources.

Supported news sources for Get_Latest_News:

Adding Your Own Tools

Decorate any public static method with [AgentTool] and [Description]. The method can live in any assembly that is loaded by the application — ToolManager scans all of them.

using System.ComponentModel;
using RichStokoe.AgentTools;

public static class MyTools
{
    [AgentTool(Type = AgentToolTypes.Read)]
    [Description("Returns a friendly greeting for the given name.")]
    public static string Greet(
        [Description("The name to greet.")] string name)
        => $"Hello, {name}!";
}

[AgentTool] has two optional properties:

No registration required — just ensure the assembly is loaded and restart.

External Services

All tools that call external services use free, no-registration APIs:

License

MIT — provided as-is, without warranty of any kind. See the LICENSE file for the full terms.