spoon-tool-development

Create and integrate BaseTool, MCPTool, and FastMCP tool components for SpoonOS agents.

Updated Jan 24, 2026
One-click install
npx skills add https://github.com/Toby1009/SpoonOS-Agent-Example --skill spoon-tool-development
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spoon-tool-development
Source: https://github.com/Toby1009/SpoonOS-Agent-Example/tree/main/.claude/skills/tool-development
Command: npx skills add https://github.com/Toby1009/SpoonOS-Agent-Example --skill spoon-tool-development

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires aiohttp, spoon_ai, pydantic, fastmcp, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Tools for SpoonOS agents enable rapid creation and integration of deterministic utilities, making agents capable of performing custom operations and interfacing with MCP servers.

Core Features & Use Cases

  • Easy to define BaseTool, MCPTool, and FastMCP-backed tools for scalable automation.
  • Example-driven workflows for local tools, remote MCP services, and tool management.
  • Use cases include building a custom price fetcher, data transformers, or orchestration tools for agents.

Quick Start

Start by implementing a simple BaseTool and registering it with your SpoonOS agent to expose a name, description, and an execute method.

Frequently Asked Questions about spoon-tool-development

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build custom tools for SpoonOS agents in Python?

To build custom tools for SpoonOS agents, implement a BaseTool class with a defined name, description, and an execute method, then register it with the agent to enable custom operations.

How do I integrate an MCP server with a Python agent tool?

Integrate an MCP server by creating an MCPTool or using FastMCP patterns, enabling your Python agent to interface with remote MCP services and execute asynchronous operations.

What is the difference between BaseTool and FastMCP for agent tool development?

BaseTool is used for implementing local Python tools with defined interfaces, while FastMCP patterns facilitate backing scalable tools and interfacing with remote MCP servers.

Do I need asynchronous handling and input validation for SpoonOS tools?

Yes, SpoonOS tools require asynchronous handling and explicit input validation, utilizing dependencies like aiohttp and pydantic to ensure robust event-driven execution.

Can I use pydantic for input validation when developing MCP tools?

Yes, pydantic is a required dependency for SpoonOS tool development, providing explicit input validation for scripts, BaseTool, and FastMCP implementations.

What are common use cases for SpoonOS agent tools?

Common use cases include building custom price fetchers, data transformers, and orchestration tools, enabling agents to perform deterministic utilities and scalable automation.