RichStokoe.AgentTools 1.1.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()
    );
}

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 tools whose name contains "Weather" (case-insensitive)
toolManager.GetTools(namePattern: "*Weather*")

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

// Read tools whose name starts with "Get"
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 flags mask — pass AgentToolTypes.Read | AgentToolTypes.Write to include all classified tools. Tools marked AgentToolTypes.None (unclassified) are only returned when no type filter is specified.

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

Web

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.