Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

tools

package

Go to main page

Versions in this module

v1

v1.30.1

Mar 11, 2026

Changes in this version

type Tool

+ ModelOverride string

type ToolCallResult

+ func ResultJSON(v any) *ToolCallResult

v1.30.0

Mar 9, 2026

Changes in this version

+ const DescriptionParam

+ func As[T any](ts ToolSet) (T, bool)

+ func ConfigureHandlers(ts ToolSet, elicitHandler ElicitationHandler, oauthHandler func(), ...)

+ func ConvertSchema(params, v any) error

+ func DescribeToolSet(ts ToolSet) string

+ func ExtractDescription(arguments string) string

+ func GetInstructions(ts ToolSet) string

+ func MustSchemaFor[T any]() any

+ func SchemaFor[T any]() (any, error)

+ func SchemaToMap(params any) (map[string]any, error)

+ func ToolsetIdentifier(ts ToolSet) string

+ type AudioContent = MediaContent

+ type ChangeNotifier interface

+ SetToolsChangedHandler func(handler func())

+ type Describer interface

+ Describe func() string

+ type Elicitable interface

+ SetElicitationHandler func(handler ElicitationHandler)

+ type ElicitationAction string

+ const ElicitationActionAccept

+ const ElicitationActionCancel

+ const ElicitationActionDecline

+ type ElicitationHandler func(ctx context.Context, req *mcp.ElicitParams) (ElicitationResult, error)

+ type ElicitationResult struct

+ Action ElicitationAction

+ Content map[string]any

+ type FunctionCall struct

+ Arguments string

+ Name string

+ type ImageContent = MediaContent

+ type Instructable interface

+ Instructions func() string

+ type MediaContent struct

+ Data string

+ MimeType string

+ type OAuthCapable interface

+ SetManagedOAuth func(managed bool)

+ SetOAuthSuccessHandler func(handler func())

+ type Startable interface

+ Start func(ctx context.Context) error

+ Stop func(ctx context.Context) error

+ type StartableToolSet struct

+ func NewStartable(ts ToolSet) *StartableToolSet

+ func (s *StartableToolSet) IsStarted() bool

+ func (s *StartableToolSet) Start(ctx context.Context) error

+ func (s *StartableToolSet) Stop(ctx context.Context) error

+ func (s *StartableToolSet) Unwrap() ToolSet

+ type Tool struct

+ AddDescriptionParameter bool

+ Annotations ToolAnnotations

+ Category string

+ Description string

+ Handler ToolHandler

+ Name string

+ OutputSchema any

+ Parameters any

+ func AddDescriptionParameter(toolList []Tool) []Tool

+ func (t *Tool) DisplayName() string

+ type ToolAnnotations mcp.ToolAnnotations

+ type ToolCall struct

+ Function FunctionCall

+ ID string

+ Type ToolType

+ type ToolCallResult struct

+ Audios []MediaContent

+ Images []MediaContent

+ IsError bool

+ Meta any

+ Output string

+ StructuredContent any

+ func ResultError(output string) *ToolCallResult

+ func ResultSuccess(output string) *ToolCallResult

+ type ToolHandler func(ctx context.Context, toolCall ToolCall) (*ToolCallResult, error)

+ func NewHandler[T any](fn func(context.Context, T) (*ToolCallResult, error)) ToolHandler

+ type ToolSet interface

+ Tools func(ctx context.Context) ([]Tool, error)

+ type ToolType string

+ type ToolsetMetadata interface

+ ToolsetID func() string

+ type Unwrapper interface

+ Unwrap func() ToolSet