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.32.3

Mar 13, 2026

v1.32.2

Mar 12, 2026

v1.32.1

Mar 12, 2026

v1.32.0

Mar 12, 2026

v1.31.0

Mar 11, 2026

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