tools

package
v0.7.1 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Apr 15, 2026 License: MIT Imports: 19 Imported by: 0

Documentation

Overview

Package tools provides MCP tool implementations for the LFX MCP server.

Package tools provides MCP tool implementations for the LFX MCP server.

Package tools provides MCP tool implementations for the LFX MCP server.

Package tools provides MCP tool implementations for the LFX MCP server.

Package tools provides MCP tool implementations for the LFX MCP server.

Package tools provides MCP tool implementations for the LFX MCP server.

Package tools provides MCP tool implementations for the LFX MCP server.

Package tools provides MCP tool implementations for the LFX MCP server.

Package tools provides MCP tool implementations for the LFX MCP server.

Package tools provides MCP tool implementations for the LFX MCP server.

Package tools provides MCP tool implementations for the LFX MCP server.

Package tools provides MCP tool implementations for the LFX MCP server.

Package tools provides MCP tool implementations for the LFX MCP server.

Package tools provides MCP tool implementations for the LFX MCP server.

Package tools provides MCP tool implementations for the LFX MCP server.

Package tools provides MCP tool implementations for the LFX MCP server.

Package tools provides MCP tool implementations for the LFX MCP server.

Index

Constants

View Source 
const (
	// ScopeRead is required for tools that only read data (ReadOnlyHint == true).
	ScopeRead = "read:all"

	// ScopeManage is required for tools that mutate data (ReadOnlyHint defaults to false).
	ScopeManage = "manage:all"
)

Scope constants used to gate tool access based on the caller's JWT scopes. These MUST match the scopes defined on the Auth0 resource server for the LFX MCP API (see auth0-terraform resource_servers.tf, lfx_mcp_api).

View Source 
const (
	// RelationWriter is required for tools that mutate project resources
	// (e.g., member onboarding).
	RelationWriter = "writer"

	// RelationAuditor is required for tools that read privileged project
	// data (e.g., LFX Lens analytics).
	RelationAuditor = "auditor"
)

Relation constants for V2 access-check. These are the service API equivalents of ScopeRead / ScopeManage — they define what project-level relationship is required, but enforcement happens inside the tool handler via the V2 access-check endpoint (not at dispatch like MCP scopes).

View Source 
const ClaimLFStaff = "http://lfx.dev/claims/lf_staff"

ClaimLFStaff is the namespaced JWT claim that indicates the user is LF staff. This claim is set by the CustomClaims Auth0 Action based on LDAP group membership (lf-staff group). Uses the lfxPrefix namespace per convention.

Variables

This section is empty.

Functions

func DefaultScopes added in v0.3.1 

func DefaultScopes() []string

DefaultScopes returns the set of scopes the server advertises via the OAuth Protected Resource Metadata endpoint. This is the enforced set plus the standard OIDC scopes that clients typically need for the authorization flow.

func HasAnyScope added in v0.7.0 

func HasAnyScope(tokenScopes, required []string) bool

HasAnyScope returns true if tokenScopes contains at least one of the required scopes.

func IsLFStaff added in v0.6.0 

func IsLFStaff(tokenInfo *auth.TokenInfo) bool

IsLFStaff returns true if the authenticated user has the lf_staff custom claim set to true in their JWT. This claim is injected by an Auth0 Action based on LDAP group membership (lf-staff group).

func RegisterAssignDiscordRole added in v0.7.0 

func RegisterAssignDiscordRole(server *mcp.Server)

RegisterAssignDiscordRole registers the assign_discord_role tool.

func RegisterCheckDiscordUserRole added in v0.7.0 

func RegisterCheckDiscordUserRole(server *mcp.Server)

RegisterCheckDiscordUserRole registers the check_discord_user_role tool.

func RegisterCreateCommittee added in v0.3.0 

func RegisterCreateCommittee(server *mcp.Server)

RegisterCreateCommittee registers the create_committee tool with the MCP server.

func RegisterCreateCommitteeMember added in v0.3.0 

func RegisterCreateCommitteeMember(server *mcp.Server)

RegisterCreateCommitteeMember registers the create_committee_member tool with the MCP server.

func RegisterCreateMembershipKeyContact added in v0.4.0 

func RegisterCreateMembershipKeyContact(server *mcp.Server)

RegisterCreateMembershipKeyContact registers the create_membership_key_contact tool with the MCP server.

func RegisterDeleteCommittee added in v0.3.0 

func RegisterDeleteCommittee(server *mcp.Server)

RegisterDeleteCommittee registers the delete_committee tool with the MCP server.

func RegisterDeleteCommitteeMember added in v0.3.0 

func RegisterDeleteCommitteeMember(server *mcp.Server)

RegisterDeleteCommitteeMember registers the delete_committee_member tool with the MCP server.

func RegisterDeleteMembershipKeyContact added in v0.4.0 

func RegisterDeleteMembershipKeyContact(server *mcp.Server)

RegisterDeleteMembershipKeyContact registers the delete_membership_key_contact tool with the MCP server.

func RegisterFindDiscordRole added in v0.7.0 

func RegisterFindDiscordRole(server *mcp.Server)

RegisterFindDiscordRole registers the find_discord_role tool.

func RegisterFindDiscordUser added in v0.7.0 

func RegisterFindDiscordUser(server *mcp.Server)

RegisterFindDiscordUser registers the find_discord_user tool.

func RegisterGetCommittee added in v0.1.1 

func RegisterGetCommittee(server *mcp.Server)

RegisterGetCommittee registers the get_committee tool with the MCP server.

func RegisterGetCommitteeMember added in v0.1.1 

func RegisterGetCommitteeMember(server *mcp.Server)

RegisterGetCommitteeMember registers the get_committee_member tool with the MCP server.

func RegisterGetMailingList added in v0.2.0 

func RegisterGetMailingList(server *mcp.Server)

RegisterGetMailingList registers the get_mailing_list tool with the MCP server.

func RegisterGetMailingListMember added in v0.2.0 

func RegisterGetMailingListMember(server *mcp.Server)

RegisterGetMailingListMember registers the get_mailing_list_member tool with the MCP server.

func RegisterGetMailingListService added in v0.2.0 

func RegisterGetMailingListService(server *mcp.Server)

RegisterGetMailingListService registers the get_mailing_list_service tool with the MCP server.

func RegisterGetMeeting added in v0.2.4 

func RegisterGetMeeting(server *mcp.Server)

RegisterGetMeeting registers the get_meeting tool with the MCP server.

func RegisterGetMeetingRegistrant added in v0.2.4 

func RegisterGetMeetingRegistrant(server *mcp.Server)

RegisterGetMeetingRegistrant registers the get_meeting_registrant tool with the MCP server.

func RegisterGetMemberMembership added in v0.2.2 

func RegisterGetMemberMembership(server *mcp.Server)

RegisterGetMemberMembership registers the get_member_membership tool with the MCP server.

func RegisterGetMembershipKeyContact added in v0.4.3 

func RegisterGetMembershipKeyContact(server *mcp.Server)

RegisterGetMembershipKeyContact registers the get_membership_key_contact tool with the MCP server.

func RegisterGetMembershipKeyContacts added in v0.2.2 

func RegisterGetMembershipKeyContacts(server *mcp.Server)

RegisterGetMembershipKeyContacts registers the get_membership_key_contacts tool with the MCP server.

func RegisterGetPastMeetingParticipant added in v0.2.6 

func RegisterGetPastMeetingParticipant(server *mcp.Server)

RegisterGetPastMeetingParticipant registers the get_past_meeting_participant tool with the MCP server.

func RegisterGetPastMeetingSummary added in v0.2.6 

func RegisterGetPastMeetingSummary(server *mcp.Server)

RegisterGetPastMeetingSummary registers the get_past_meeting_summary tool with the MCP server.

func RegisterGetPastMeetingTranscript added in v0.2.6 

func RegisterGetPastMeetingTranscript(server *mcp.Server)

RegisterGetPastMeetingTranscript registers the get_past_meeting_transcript tool with the MCP server.

func RegisterGetProject added in v0.1.0 

func RegisterGetProject(server *mcp.Server)

RegisterGetProject registers the get_project tool with the MCP server.

func RegisterGetProjectTier added in v0.4.3 

func RegisterGetProjectTier(server *mcp.Server)

RegisterGetProjectTier registers the get_project_tier tool with the MCP server.

func RegisterHelloWorld 

func RegisterHelloWorld(server *mcp.Server)

RegisterHelloWorld registers the hello_world tool with the MCP server.

func RegisterListB2bOrgMemberships added in v0.5.0 

func RegisterListB2bOrgMemberships(server *mcp.Server)

RegisterListB2bOrgMemberships registers the list_b2b_org_memberships tool with the MCP server.

func RegisterListDiscordRoles added in v0.7.0 

func RegisterListDiscordRoles(server *mcp.Server)

RegisterListDiscordRoles registers the list_discord_roles tool.

func RegisterListEmailTemplates added in v0.7.0 

func RegisterListEmailTemplates(server *mcp.Server)

RegisterListEmailTemplates registers the list_email_templates tool.

func RegisterListProjectTiers added in v0.4.3 

func RegisterListProjectTiers(server *mcp.Server)

RegisterListProjectTiers registers the list_project_tiers tool with the MCP server.

func RegisterQueryLFXLens added in v0.7.0 

func RegisterQueryLFXLens(server *mcp.Server)

RegisterQueryLFXLens registers the query_lfx_lens tool.

func RegisterSearchB2bOrgs added in v0.5.0 

func RegisterSearchB2bOrgs(server *mcp.Server)

RegisterSearchB2bOrgs registers the search_b2b_orgs tool with the MCP server.

func RegisterSearchCommitteeMembers added in v0.1.1 

func RegisterSearchCommitteeMembers(server *mcp.Server)

RegisterSearchCommitteeMembers registers the search_committee_members tool with the MCP server.

func RegisterSearchCommittees added in v0.1.1 

func RegisterSearchCommittees(server *mcp.Server)

RegisterSearchCommittees registers the search_committees tool with the MCP server.

func RegisterSearchMailingListMembers added in v0.2.0 

func RegisterSearchMailingListMembers(server *mcp.Server)

RegisterSearchMailingListMembers registers the search_mailing_list_members tool with the MCP server.

func RegisterSearchMailingLists added in v0.2.0 

func RegisterSearchMailingLists(server *mcp.Server)

RegisterSearchMailingLists registers the search_mailing_lists tool with the MCP server.

func RegisterSearchMeetingRegistrants added in v0.2.4 

func RegisterSearchMeetingRegistrants(server *mcp.Server)

RegisterSearchMeetingRegistrants registers the search_meeting_registrants tool with the MCP server.

func RegisterSearchMeetings added in v0.2.4 

func RegisterSearchMeetings(server *mcp.Server)

RegisterSearchMeetings registers the search_meetings tool with the MCP server.

func RegisterSearchMembers added in v0.2.2 

func RegisterSearchMembers(server *mcp.Server)

RegisterSearchMembers registers the search_members tool with the MCP server.

func RegisterSearchPastMeetingParticipants added in v0.2.6 

func RegisterSearchPastMeetingParticipants(server *mcp.Server)

RegisterSearchPastMeetingParticipants registers the search_past_meeting_participants tool with the MCP server.

func RegisterSearchPastMeetingSummaries added in v0.2.6 

func RegisterSearchPastMeetingSummaries(server *mcp.Server)

RegisterSearchPastMeetingSummaries registers the search_past_meeting_summaries tool with the MCP server.

func RegisterSearchPastMeetingTranscripts added in v0.2.6 

func RegisterSearchPastMeetingTranscripts(server *mcp.Server)

RegisterSearchPastMeetingTranscripts registers the search_past_meeting_transcripts tool with the MCP server.

func RegisterSearchProjects added in v0.1.0 

func RegisterSearchProjects(server *mcp.Server)

RegisterSearchProjects registers the search_projects tool with the MCP server.

func RegisterSendEmail added in v0.7.0 

func RegisterSendEmail(server *mcp.Server)

RegisterSendEmail registers the send_email tool.

func RegisterUpdateCommittee added in v0.3.0 

func RegisterUpdateCommittee(server *mcp.Server)

RegisterUpdateCommittee registers the update_committee tool with the MCP server.

func RegisterUpdateCommitteeMember added in v0.3.0 

func RegisterUpdateCommitteeMember(server *mcp.Server)

RegisterUpdateCommitteeMember registers the update_committee_member tool with the MCP server.

func RegisterUpdateCommitteeSettings added in v0.3.0 

func RegisterUpdateCommitteeSettings(server *mcp.Server)

RegisterUpdateCommitteeSettings registers the update_committee_settings tool with the MCP server.

func RegisterUpdateMembershipKeyContact added in v0.4.0 

func RegisterUpdateMembershipKeyContact(server *mcp.Server)

RegisterUpdateMembershipKeyContact registers the update_membership_key_contact tool with the MCP server.

func RegisterUserInfo 

func RegisterUserInfo(server *mcp.Server)

RegisterUserInfo registers the user_info tool with the MCP server.

func SetCommitteeConfig added in v0.1.1 

func SetCommitteeConfig(cfg *CommitteeConfig)

SetCommitteeConfig sets the configuration for committee tools.

func SetLensConfig added in v0.6.0 

func SetLensConfig(cfg *LensConfig)

SetLensConfig sets the configuration for LFX Lens tools.

func SetMailingListConfig added in v0.2.0 

func SetMailingListConfig(cfg *MailingListConfig)

SetMailingListConfig sets the configuration for mailing list tools.

func SetMeetingConfig added in v0.2.4 

func SetMeetingConfig(cfg *MeetingConfig)

SetMeetingConfig sets the configuration for meeting tools.

func SetMemberConfig added in v0.2.2 

func SetMemberConfig(cfg *MemberConfig)

SetMemberConfig sets the configuration for member tools.

func SetOnboardingConfig added in v0.6.0 

func SetOnboardingConfig(cfg *OnboardingConfig)

SetOnboardingConfig sets the configuration for onboarding tools.

func SetProjectConfig added in v0.1.0 

func SetProjectConfig(cfg *ProjectConfig)

SetProjectConfig sets the configuration for project tools.

func SetUserInfoConfig 

func SetUserInfoConfig(cfg *UserInfoConfig)

SetUserInfoConfig sets the configuration for the user_info tool.

func ValidateScopes added in v0.3.1 

func ValidateScopes(configured []string, warn func(msg string, args ...any)) []string

ValidateScopes checks a configured scope list for unrecognised entries and returns it unchanged. It logs a warning for any scope that is neither an enforced scope nor a standard OIDC scope — those will be advertised via the PRM but are not enforced by the server. Omitting an enforced scope from the configured list is intentional and allowed; enforcement at registration time is independent of what is advertised.

func WithLogger added in v0.4.5 

func WithLogger(ctx context.Context, l *slog.Logger) context.Context

WithLogger returns a new context with the given logger stored in it. The middleware calls this before invoking the tool handler so that session_id and mcp_method are pre-bound on every log record.

Types

type CommitteeConfig added in v0.1.1 

type CommitteeConfig struct {
	// Clients is the shared LFX v2 API client instance. It must be created once
	// at startup so that its token cache persists across requests.
	Clients *lfxv2.Clients
}

CommitteeConfig holds configuration shared by committee tools.

type CommitteeMemberOrganizationArgs added in v0.3.0 

type CommitteeMemberOrganizationArgs struct {
	Name    *string `json:"name,omitempty" jsonschema:"Organization name"`
	Website *string `json:"website,omitempty" jsonschema:"Organization website URL"`
}

CommitteeMemberOrganizationArgs defines organization information for a committee member.

type CommitteeMemberRoleArgs added in v0.3.0 

type CommitteeMemberRoleArgs struct {
	Name      string  `json:"name" jsonschema:"Role name"`
	StartDate *string `json:"start_date,omitempty" jsonschema:"Role start date in RFC3339 format"`
	EndDate   *string `json:"end_date,omitempty" jsonschema:"Role end date in RFC3339 format"`
}

CommitteeMemberRoleArgs defines role information for a committee member.

type CommitteeMemberVotingArgs added in v0.3.0 

type CommitteeMemberVotingArgs struct {
	Status    string  `json:"status" jsonschema:"Voting status"`
	StartDate *string `json:"start_date,omitempty" jsonschema:"Voting start date in RFC3339 format"`
	EndDate   *string `json:"end_date,omitempty" jsonschema:"Voting end date in RFC3339 format"`
}

CommitteeMemberVotingArgs defines voting information for a committee member.

type CreateCommitteeArgs added in v0.3.0 

type CreateCommitteeArgs struct {
	ProjectUID            string  `json:"project_uid" jsonschema:"Project UID the committee belongs to"`
	Name                  string  `json:"name" jsonschema:"Name of the committee"`
	Category              string  `json:"category" jsonschema:"Category of the committee"`
	Description           *string `json:"description,omitempty" jsonschema:"Description of the committee"`
	Website               *string `json:"website,omitempty" jsonschema:"Website URL of the committee"`
	EnableVoting          bool    `json:"enable_voting,omitempty" jsonschema:"Whether voting is enabled"`
	SSOGroupEnabled       bool    `json:"sso_group_enabled,omitempty" jsonschema:"Whether SSO group integration is enabled"`
	RequiresReview        bool    `json:"requires_review,omitempty" jsonschema:"Whether the committee requires review"`
	Public                bool    `json:"public,omitempty" jsonschema:"Whether the committee is publicly visible"`
	CalendarPublic        *bool   `json:"calendar_public,omitempty" jsonschema:"Whether the committee calendar is publicly visible"`
	DisplayName           *string `json:"display_name,omitempty" jsonschema:"Display name of the committee"`
	ParentUID             *string `json:"parent_uid,omitempty" jsonschema:"UID of the parent committee, if any"`
	BusinessEmailRequired bool    `json:"business_email_required,omitempty" jsonschema:"Whether business email is required for members"`
	MemberVisibility      string  `json:"member_visibility,omitempty" jsonschema:"Visibility level of member profiles to other members"`
	ShowMeetingAttendees  bool    `json:"show_meeting_attendees,omitempty" jsonschema:"Whether to show meeting attendees by default"`
}

CreateCommitteeArgs defines the input parameters for the create_committee tool.

type CreateCommitteeMemberArgs added in v0.3.0 

type CreateCommitteeMemberArgs struct {
	CommitteeUID    string                           `json:"committee_uid" jsonschema:"UID of the committee to add the member to"`
	Email           string                           `json:"email" jsonschema:"Primary email address of the member"`
	AppointedBy     string                           `json:"appointed_by" jsonschema:"How the member was appointed"`
	Status          string                           `json:"status" jsonschema:"Member status"`
	FirstName       *string                          `json:"first_name,omitempty" jsonschema:"First name"`
	LastName        *string                          `json:"last_name,omitempty" jsonschema:"Last name"`
	JobTitle        *string                          `json:"job_title,omitempty" jsonschema:"Job title at organization"`
	LinkedinProfile *string                          `json:"linkedin_profile,omitempty" jsonschema:"LinkedIn profile URL"`
	Role            *CommitteeMemberRoleArgs         `json:"role,omitempty" jsonschema:"Committee role information"`
	Voting          *CommitteeMemberVotingArgs       `json:"voting,omitempty" jsonschema:"Voting information"`
	Organization    *CommitteeMemberOrganizationArgs `json:"organization,omitempty" jsonschema:"Organization information"`
}

CreateCommitteeMemberArgs defines the input parameters for the create_committee_member tool.

type CreateMembershipKeyContactArgs added in v0.4.0 

type CreateMembershipKeyContactArgs struct {
	ProjectUID     string  `json:"project_uid" jsonschema:"Project UUID"`
	MembershipUID  string  `json:"membership_uid" jsonschema:"Membership UID"`
	Email          string  `json:"email" jsonschema:"Contact email address; used to resolve or create the Salesforce Contact record"`
	FirstName      string  `json:"first_name" jsonschema:"Contact first name; used when creating a new Contact on miss"`
	LastName       string  `json:"last_name" jsonschema:"Contact last name; used when creating a new Contact on miss"`
	Title          *string `json:"title,omitempty" jsonschema:"Contact job title; used when creating a new Contact on miss"`
	Role           *string `json:"role,omitempty" jsonschema:"Contact role designation, e.g. 'Voting Representative'"`
	Status         *string `json:"status,omitempty" jsonschema:"Role record status, e.g. 'Active'"`
	BoardMember    *bool   `json:"board_member,omitempty" jsonschema:"Whether this contact holds a board member role"`
	PrimaryContact *bool   `json:"primary_contact,omitempty" jsonschema:"Whether this is the primary contact for the membership"`
}

CreateMembershipKeyContactArgs defines the input parameters for the create_membership_key_contact tool.

type DeleteCommitteeArgs added in v0.3.0 

type DeleteCommitteeArgs struct {
	UID string `json:"uid" jsonschema:"UID of the committee to delete"`
}

DeleteCommitteeArgs defines the input parameters for the delete_committee tool.

type DeleteCommitteeMemberArgs added in v0.3.0 

type DeleteCommitteeMemberArgs struct {
	CommitteeUID string `json:"committee_uid" jsonschema:"UID of the committee"`
	MemberUID    string `json:"member_uid" jsonschema:"UID of the member to delete"`
}

DeleteCommitteeMemberArgs defines the input parameters for the delete_committee_member tool.

type DeleteMembershipKeyContactArgs added in v0.4.0 

type DeleteMembershipKeyContactArgs struct {
	ProjectUID    string `json:"project_uid" jsonschema:"Project UUID"`
	MembershipUID string `json:"membership_uid" jsonschema:"Membership UID"`
	ContactUID    string `json:"contact_uid" jsonschema:"Key contact UID to remove"`
}

DeleteMembershipKeyContactArgs defines the input parameters for the delete_membership_key_contact tool.

type DiscordAssignRoleArgs added in v0.7.0 

type DiscordAssignRoleArgs struct {
	ProjectSlug string `json:"project_slug" jsonschema:"Project slug (e.g. 'pytorch')"`
	UserID      string `json:"user_id" jsonschema:"Discord user ID"`
	UserName    string `json:"user_name" jsonschema:"Human-readable name (for logging/display)"`
	RoleID      string `json:"role_id" jsonschema:"Discord role ID"`
	RoleName    string `json:"role_name" jsonschema:"Human-readable role name (for logging/display)"`
}

DiscordAssignRoleArgs defines the input for assign_discord_role.

type DiscordCheckUserRoleArgs added in v0.7.0 

type DiscordCheckUserRoleArgs struct {
	ProjectSlug string `json:"project_slug" jsonschema:"Project slug (e.g. 'pytorch')"`
	UserID      string `json:"user_id" jsonschema:"Discord user ID"`
	RoleID      string `json:"role_id" jsonschema:"Discord role ID"`
}

DiscordCheckUserRoleArgs defines the input for check_discord_user_role.

type DiscordFindRoleArgs added in v0.7.0 

type DiscordFindRoleArgs struct {
	ProjectSlug string `json:"project_slug" jsonschema:"Project slug (e.g. 'pytorch')"`
	RoleName    string `json:"role_name" jsonschema:"Role name to search for"`
}

DiscordFindRoleArgs defines the input for find_discord_role.

type DiscordFindUserArgs added in v0.7.0 

type DiscordFindUserArgs struct {
	ProjectSlug string `json:"project_slug" jsonschema:"Project slug (e.g. 'pytorch')"`
	Name        string `json:"name" jsonschema:"Member name to search for"`
	Email       string `json:"email,omitempty" jsonschema:"Email address; local part used as additional search term"`
}

DiscordFindUserArgs defines the input for find_discord_user.

type DiscordProjectSlugArgs added in v0.7.0 

type DiscordProjectSlugArgs struct {
	ProjectSlug string `json:"project_slug" jsonschema:"Project slug (e.g. 'pytorch')"`
}

DiscordProjectSlugArgs is the common argument for tools that only need a project slug.

type EmailProjectSlugArgs added in v0.7.0 

type EmailProjectSlugArgs struct {
	ProjectSlug string `json:"project_slug" jsonschema:"Project slug (e.g. 'pytorch')"`
}

EmailProjectSlugArgs is the common argument for email tools that only need a project slug.

type GetCommitteeArgs added in v0.1.1 

type GetCommitteeArgs struct {
	UID string `json:"uid" jsonschema:"The UID of the committee to retrieve"`
}

GetCommitteeArgs defines the input parameters for the get_committee tool.

type GetCommitteeMemberArgs added in v0.1.1 

type GetCommitteeMemberArgs struct {
	CommitteeUID string `json:"committee_uid" jsonschema:"The UID of the committee"`
	MemberUID    string `json:"member_uid" jsonschema:"The UID of the committee member"`
}

GetCommitteeMemberArgs defines the input parameters for the get_committee_member tool.

type GetMailingListArgs added in v0.2.0 

type GetMailingListArgs struct {
	ID string `json:"id" jsonschema:"The Groups.io numeric group ID of the mailing list to retrieve (e.g. 145670)"`
}

GetMailingListArgs defines the input parameters for the get_mailing_list tool.

type GetMailingListMemberArgs added in v0.2.0 

type GetMailingListMemberArgs struct {
	MailingListID string `json:"mailing_list_id" jsonschema:"The Groups.io numeric group ID of the mailing list (e.g. 145670)"`
	MemberID      string `json:"member_id" jsonschema:"The Groups.io numeric member ID (e.g. 14875835)"`
}

GetMailingListMemberArgs defines the input parameters for the get_mailing_list_member tool.

type GetMailingListServiceArgs added in v0.2.0 

type GetMailingListServiceArgs struct {
	UID string `json:"uid" jsonschema:"The UID of the mailing list service to retrieve"`
}

GetMailingListServiceArgs defines the input parameters for the get_mailing_list_service tool.

type GetMeetingArgs added in v0.2.4 

type GetMeetingArgs struct {
	UID string `json:"uid" jsonschema:"The UID of the meeting to retrieve"`
}

GetMeetingArgs defines the input parameters for the get_meeting tool.

type GetMeetingRegistrantArgs added in v0.2.4 

type GetMeetingRegistrantArgs struct {
	UID string `json:"uid" jsonschema:"The UID of the meeting registrant to retrieve"`
}

GetMeetingRegistrantArgs defines the input parameters for the get_meeting_registrant tool.

type GetMemberMembershipArgs added in v0.2.2 

type GetMemberMembershipArgs struct {
	ProjectUID    string `json:"project_uid" jsonschema:"Project UUID"`
	MembershipUID string `json:"membership_uid" jsonschema:"The membership UID"`
}

GetMemberMembershipArgs defines the input parameters for the get_member_membership tool.

type GetMembershipKeyContactArgs added in v0.4.3 

type GetMembershipKeyContactArgs struct {
	ProjectUID    string `json:"project_uid" jsonschema:"Project UUID"`
	MembershipUID string `json:"membership_uid" jsonschema:"The membership UID"`
	ContactUID    string `json:"contact_uid" jsonschema:"Key contact UID"`
}

GetMembershipKeyContactArgs defines the input parameters for the get_membership_key_contact tool.

type GetMembershipKeyContactsArgs added in v0.2.2 

type GetMembershipKeyContactsArgs struct {
	ProjectUID    string `json:"project_uid" jsonschema:"Project UUID"`
	MembershipUID string `json:"membership_uid" jsonschema:"The membership UID"`
}

GetMembershipKeyContactsArgs defines the input parameters for the get_membership_key_contacts tool.

type GetPastMeetingParticipantArgs added in v0.2.6 

type GetPastMeetingParticipantArgs struct {
	UID string `json:"uid" jsonschema:"The UID of the past meeting participant to retrieve"`
}

GetPastMeetingParticipantArgs defines the input parameters for the get_past_meeting_participant tool.

type GetPastMeetingSummaryArgs added in v0.2.6 

type GetPastMeetingSummaryArgs struct {
	UID string `json:"uid" jsonschema:"The UID of the past meeting summary to retrieve"`
}

GetPastMeetingSummaryArgs defines the input parameters for the get_past_meeting_summary tool.

type GetPastMeetingTranscriptArgs added in v0.2.6 

type GetPastMeetingTranscriptArgs struct {
	UID string `json:"uid" jsonschema:"The UID of the past meeting transcript to retrieve"`
}

GetPastMeetingTranscriptArgs defines the input parameters for the get_past_meeting_transcript tool.

type GetProjectArgs added in v0.1.0 

type GetProjectArgs struct {
	UID string `json:"uid" jsonschema:"The UID of the project to retrieve"`
}

GetProjectArgs defines the input parameters for the get_project tool.

type GetProjectTierArgs added in v0.4.3 

type GetProjectTierArgs struct {
	ProjectUID string `json:"project_uid" jsonschema:"Project UUID (required)"`
	TierUID    string `json:"tier_uid" jsonschema:"Membership tier UID"`
}

GetProjectTierArgs defines the input parameters for the get_project_tier tool.

type HelloWorldArgs 

type HelloWorldArgs struct {
	Name    string `json:"name,omitempty" jsonschema:"Name to greet (optional, defaults to 'World')"`
	Message string `json:"message,omitempty" jsonschema:"Custom greeting message (optional)"`
}

HelloWorldArgs defines the input parameters for the hello_world tool.

type LensConfig added in v0.6.0 

type LensConfig struct {
	ServiceAuth
	ServiceClient *serviceapi.Client
}

LensConfig holds configuration shared by LFX Lens tools.

type ListB2bOrgMembershipsArgs added in v0.5.0 

type ListB2bOrgMembershipsArgs struct {
	B2bOrgUID string `json:"b2b_org_uid" jsonschema:"B2B organization UID (required)"`
	Sort      string `json:"sort,omitempty" jsonschema:"Sort order: newest (default), name, last_modified"`
	PageSize  int    `json:"page_size,omitempty" jsonschema:"Number of results per page (default 10, max 1000)"`
	PageToken string `json:"page_token,omitempty" jsonschema:"Opaque cursor from a previous response to fetch the next page"`
}

ListB2bOrgMembershipsArgs defines the input parameters for the list_b2b_org_memberships tool.

type ListProjectTiersArgs added in v0.4.3 

type ListProjectTiersArgs struct {
	ProjectUID string `json:"project_uid" jsonschema:"Project UUID (required)"`
}

ListProjectTiersArgs defines the input parameters for the list_project_tiers tool.

type MailingListConfig added in v0.2.0 

type MailingListConfig struct {
	// Clients is the shared LFX v2 API client instance. It must be created once
	// at startup so that its token cache persists across requests.
	Clients *lfxv2.Clients
}

MailingListConfig holds configuration shared by mailing list tools.

type MeetingConfig added in v0.2.4 

type MeetingConfig struct {
	// Clients is the shared LFX v2 API client instance. It must be created once
	// at startup so that its token cache persists across requests.
	Clients *lfxv2.Clients
}

MeetingConfig holds configuration shared by meeting tools.

type MemberConfig added in v0.2.2 

type MemberConfig struct {
	// Clients is the shared LFX v2 API client instance. It must be created once
	// at startup so that its token cache persists across requests.
	Clients *lfxv2.Clients
}

MemberConfig holds configuration shared by member tools.

type OnboardingConfig added in v0.6.0 

type OnboardingConfig struct {
	ServiceAuth
	ServiceClient *serviceapi.Client
}

OnboardingConfig holds configuration shared by member onboarding tools.

type ProjectConfig added in v0.1.0 

type ProjectConfig struct {
	// Clients is the shared LFX v2 API client instance. It must be created once
	// at startup so that its token cache persists across requests.
	Clients *lfxv2.Clients
}

ProjectConfig holds configuration shared by project tools.

type QueryLFXLensArgs added in v0.7.0 

type QueryLFXLensArgs struct {
	ProjectSlug string `json:"project_slug" jsonschema:"Project slug from search_projects (e.g. 'cncf')"`
	Input       string `` /* 127-byte string literal not displayed */
}

QueryLFXLensArgs defines the input for query_lfx_lens.

type SearchB2bOrgsArgs added in v0.5.0 

type SearchB2bOrgsArgs struct {
	SearchName string `json:"search_name,omitempty" jsonschema:"Search B2B organizations by name (case-insensitive substring match)."`
	Sort       string `json:"sort,omitempty" jsonschema:"Sort order: newest (default), name, last_modified"`
	PageSize   int    `json:"page_size,omitempty" jsonschema:"Number of results per page (default 10, max 1000)"`
	PageToken  string `json:"page_token,omitempty" jsonschema:"Opaque cursor from a previous response to fetch the next page"`
}

SearchB2bOrgsArgs defines the input parameters for the search_b2b_orgs tool.

type SearchCommitteeMembersArgs added in v0.1.1 

type SearchCommitteeMembersArgs struct {
	CommitteeUID string `json:"committee_uid,omitempty" jsonschema:"Optional UID of the committee to filter members by"`
	ProjectUID   string `json:"project_uid,omitempty" jsonschema:"Optional project UID to filter committee members by project"`
	Name         string `json:"name,omitempty" jsonschema:"Name or partial name of the member to search for"`
	PageSize     int    `json:"page_size,omitempty" jsonschema:"Number of results per page (default 10, max 100)"`
	PageToken    string `json:"page_token,omitempty" jsonschema:"Opaque pagination token from a previous search response"`
}

SearchCommitteeMembersArgs defines the input parameters for the search_committee_members tool.

type SearchCommitteesArgs added in v0.1.1 

type SearchCommitteesArgs struct {
	Name       string `json:"name,omitempty" jsonschema:"Name or partial name of the committee to search for"`
	ProjectUID string `json:"project_uid,omitempty" jsonschema:"Optional project UID to filter committees by project"`
	PageSize   int    `json:"page_size,omitempty" jsonschema:"Number of results per page (default 10, max 100)"`
	PageToken  string `json:"page_token,omitempty" jsonschema:"Opaque pagination token from a previous search response"`
}

SearchCommitteesArgs defines the input parameters for the search_committees tool.

type SearchMailingListMembersArgs added in v0.2.0 

type SearchMailingListMembersArgs struct {
	MailingListID string `` /* 136-byte string literal not displayed */
	ProjectUID    string `json:"project_uid,omitempty" jsonschema:"Optional project UID to filter mailing list members by project"`
	Name          string `json:"name,omitempty" jsonschema:"Name or partial name of the member to search for"`
	PageSize      int    `json:"page_size,omitempty" jsonschema:"Number of results per page (default 10)"`
	PageToken     string `json:"page_token,omitempty" jsonschema:"Opaque pagination token from a previous search response"`
}

SearchMailingListMembersArgs defines the input parameters for the search_mailing_list_members tool.

type SearchMailingListsArgs added in v0.2.0 

type SearchMailingListsArgs struct {
	Name       string `json:"name,omitempty" jsonschema:"Name or partial name of the mailing list to search for"`
	ProjectUID string `json:"project_uid,omitempty" jsonschema:"Optional project UID to filter mailing lists by project"`
	PageSize   int    `json:"page_size,omitempty" jsonschema:"Number of results per page (default 10)"`
	PageToken  string `json:"page_token,omitempty" jsonschema:"Opaque pagination token from a previous search response"`
}

SearchMailingListsArgs defines the input parameters for the search_mailing_lists tool.

type SearchMeetingRegistrantsArgs added in v0.2.4 

type SearchMeetingRegistrantsArgs struct {
	MeetingID    string   `json:"meeting_id,omitempty" jsonschema:"Filter registrants by meeting ID"`
	CommitteeUID string   `json:"committee_uid,omitempty" jsonschema:"Filter registrants by committee UID"`
	ProjectUID   string   `json:"project_uid,omitempty" jsonschema:"Filter registrants by project UID"`
	Name         string   `json:"name,omitempty" jsonschema:"Name or partial name of the registrant to search for"`
	Filters      []string `json:"filters,omitempty" jsonschema:"Direct field:value term filters (e.g. host:true or type:committee)"`
	Sort         string   `` /* 140-byte string literal not displayed */
	PageSize     int      `json:"page_size,omitempty" jsonschema:"Number of results per page (default 10, max 100)"`
	PageToken    string   `json:"page_token,omitempty" jsonschema:"Opaque pagination token from a previous search response"`
}

SearchMeetingRegistrantsArgs defines the input parameters for the search_meeting_registrants tool.

type SearchMeetingsArgs added in v0.2.4 

type SearchMeetingsArgs struct {
	Name         string   `json:"name,omitempty" jsonschema:"Name or partial name of the meeting to search for"`
	ProjectUID   string   `json:"project_uid,omitempty" jsonschema:"Filter meetings by project UID"`
	CommitteeUID string   `json:"committee_uid,omitempty" jsonschema:"Filter meetings by committee UID"`
	DateField    string   `json:"date_field,omitempty" jsonschema:"Date field to filter on (default start_time when date_from or date_to is set)"`
	DateFrom     string   `json:"date_from,omitempty" jsonschema:"Start date inclusive in ISO 8601 format (e.g. 2025-01-01)"`
	DateTo       string   `json:"date_to,omitempty" jsonschema:"End date inclusive in ISO 8601 format (e.g. 2025-12-31)"`
	Filters      []string `json:"filters,omitempty" jsonschema:"Direct field:value term filters (e.g. visibility:public or status:active)"`
	Sort         string   `` /* 140-byte string literal not displayed */
	PageSize     int      `json:"page_size,omitempty" jsonschema:"Number of results per page (default 10, max 100)"`
	PageToken    string   `json:"page_token,omitempty" jsonschema:"Opaque pagination token from a previous search response"`
}

SearchMeetingsArgs defines the input parameters for the search_meetings tool.

type SearchMembersArgs added in v0.2.2 

type SearchMembersArgs struct {
	ProjectUID string `json:"project_uid" jsonschema:"Project UUID (required)"`
	SearchName string `json:"search_name,omitempty" jsonschema:"Search memberships by member company name (case-insensitive substring match)."`
	TierUID    string `json:"tier_uid,omitempty" jsonschema:"Filter by membership tier UID (UUID from list_project_tiers)"`
	Sort       string `json:"sort,omitempty" jsonschema:"Sort order: newest (default), name, last_modified"`
	PageSize   int    `json:"page_size,omitempty" jsonschema:"Number of results per page (default 10, max 100)"`
	PageToken  string `json:"page_token,omitempty" jsonschema:"Opaque cursor from a previous response to fetch the next page"`
}

SearchMembersArgs defines the input parameters for the search_members tool.

type SearchPastMeetingParticipantsArgs added in v0.2.6 

type SearchPastMeetingParticipantsArgs struct {
	MeetingID    string   `json:"meeting_id,omitempty" jsonschema:"Filter participants by meeting ID"`
	CommitteeUID string   `json:"committee_uid,omitempty" jsonschema:"Filter participants by committee UID"`
	ProjectUID   string   `json:"project_uid,omitempty" jsonschema:"Filter participants by project UID"`
	Name         string   `json:"name,omitempty" jsonschema:"Name or partial name of the participant to search for"`
	Filters      []string `json:"filters,omitempty" jsonschema:"Direct field:value term filters"`
	Sort         string   `` /* 140-byte string literal not displayed */
	PageSize     int      `json:"page_size,omitempty" jsonschema:"Number of results per page (default 10, max 100)"`
	PageToken    string   `json:"page_token,omitempty" jsonschema:"Opaque pagination token from a previous search response"`
}

SearchPastMeetingParticipantsArgs defines the input parameters for the search_past_meeting_participants tool.

type SearchPastMeetingSummariesArgs added in v0.2.6 

type SearchPastMeetingSummariesArgs struct {
	MeetingID    string   `json:"meeting_id,omitempty" jsonschema:"Filter summaries by meeting ID"`
	CommitteeUID string   `json:"committee_uid,omitempty" jsonschema:"Filter summaries by committee UID"`
	ProjectUID   string   `json:"project_uid,omitempty" jsonschema:"Filter summaries by project UID"`
	Name         string   `json:"name,omitempty" jsonschema:"Name or partial name of the summary to search for"`
	Filters      []string `json:"filters,omitempty" jsonschema:"Direct field:value term filters"`
	Sort         string   `` /* 140-byte string literal not displayed */
	PageSize     int      `json:"page_size,omitempty" jsonschema:"Number of results per page (default 10, max 100)"`
	PageToken    string   `json:"page_token,omitempty" jsonschema:"Opaque pagination token from a previous search response"`
}

SearchPastMeetingSummariesArgs defines the input parameters for the search_past_meeting_summaries tool.

type SearchPastMeetingTranscriptsArgs added in v0.2.6 

type SearchPastMeetingTranscriptsArgs struct {
	MeetingID    string   `json:"meeting_id,omitempty" jsonschema:"Filter transcripts by meeting ID"`
	CommitteeUID string   `json:"committee_uid,omitempty" jsonschema:"Filter transcripts by committee UID"`
	ProjectUID   string   `json:"project_uid,omitempty" jsonschema:"Filter transcripts by project UID"`
	Name         string   `json:"name,omitempty" jsonschema:"Name or partial name of the transcript to search for"`
	Filters      []string `json:"filters,omitempty" jsonschema:"Direct field:value term filters"`
	Sort         string   `` /* 140-byte string literal not displayed */
	PageSize     int      `json:"page_size,omitempty" jsonschema:"Number of results per page (default 10, max 100)"`
	PageToken    string   `json:"page_token,omitempty" jsonschema:"Opaque pagination token from a previous search response"`
}

SearchPastMeetingTranscriptsArgs defines the input parameters for the search_past_meeting_transcripts tool.

type SearchProjectsArgs added in v0.1.0 

type SearchProjectsArgs struct {
	Name      string `json:"name,omitempty" jsonschema:"Name or partial name of the project to search for"`
	ParentUID string `json:"parent_uid,omitempty" jsonschema:"Optional UID of a foundation or umbrella project to filter child projects by"`
	PageSize  int    `json:"page_size,omitempty" jsonschema:"Number of results per page (default 10, max 100)"`
	PageToken string `json:"page_token,omitempty" jsonschema:"Opaque pagination token from a previous search response"`
}

SearchProjectsArgs defines the input parameters for the search_projects tool.

type SendEmailArgs added in v0.7.0 

type SendEmailArgs struct {
	ProjectSlug  string            `json:"project_slug" jsonschema:"Project slug (e.g. 'pytorch')"`
	Mode         string            `json:"mode" jsonschema:"Operation mode,enum=draft,enum=send"`
	TemplateName string            `json:"template_name" jsonschema:"Name of the email template"`
	Variables    map[string]string `json:"variables,omitempty" jsonschema:"Jinja2 template variables (e.g. company_name, project_name)"`
	ToEmail      string            `json:"to_email,omitempty" jsonschema:"Recipient email address (required for mode=send)"`
	ToName       string            `json:"to_name,omitempty" jsonschema:"Recipient display name (required for mode=send)"`
}

SendEmailArgs defines the input for send_email.

type ServiceAuth added in v0.6.0 

type ServiceAuth struct {
	LFXAPIURL           string
	TokenExchangeClient *lfxv2.TokenExchangeClient
	DebugLogger         *slog.Logger
	SlugResolver        *lfxv2.SlugResolver
	AccessChecker       *lfxv2.AccessCheckClient
}

ServiceAuth holds the shared infrastructure needed by all service API tools for token exchange, slug resolution, and access-check. Both OnboardingConfig and LensConfig embed this struct.

func (*ServiceAuth) AuthorizeProject added in v0.6.0 

func (s *ServiceAuth) AuthorizeProject(ctx context.Context, req *mcp.CallToolRequest, slug, relation string) (context.Context, error)

AuthorizeProject performs the standard service tool authorization flow:

  1. Extract MCP token from the request
  2. Create V2 API clients (with token exchange)
  3. Resolve the project slug to a V2 UUID
  4. Verify the user has the required relation via access-check

On success it returns the enriched context (with MCP token attached). On failure it returns an error — the MCP SDK automatically wraps returned errors into a CallToolResult with IsError set, so callers can propagate the error directly as the handler's error return value.

type UpdateCommitteeArgs added in v0.3.0 

type UpdateCommitteeArgs struct {
	UID             string  `json:"uid" jsonschema:"UID of the committee to update"`
	ProjectUID      *string `json:"project_uid,omitempty" jsonschema:"Project UID the committee belongs to"`
	Name            *string `json:"name,omitempty" jsonschema:"Name of the committee"`
	Category        *string `json:"category,omitempty" jsonschema:"Category of the committee"`
	Description     *string `json:"description,omitempty" jsonschema:"Description of the committee"`
	Website         *string `json:"website,omitempty" jsonschema:"Website URL of the committee"`
	EnableVoting    *bool   `json:"enable_voting,omitempty" jsonschema:"Whether voting is enabled"`
	SSOGroupEnabled *bool   `json:"sso_group_enabled,omitempty" jsonschema:"Whether SSO group integration is enabled"`
	RequiresReview  *bool   `json:"requires_review,omitempty" jsonschema:"Whether the committee requires review"`
	Public          *bool   `json:"public,omitempty" jsonschema:"Whether the committee is publicly visible"`
	CalendarPublic  *bool   `json:"calendar_public,omitempty" jsonschema:"Whether the committee calendar is publicly visible"`
	DisplayName     *string `json:"display_name,omitempty" jsonschema:"Display name of the committee"`
	ParentUID       *string `json:"parent_uid,omitempty" jsonschema:"UID of the parent committee, if any"`
}

UpdateCommitteeArgs defines the input parameters for the update_committee tool. Only fields that are provided (non-nil) will be updated; omitted fields retain their current values (fetch-then-merge semantics).

type UpdateCommitteeMemberArgs added in v0.3.0 

type UpdateCommitteeMemberArgs struct {
	CommitteeUID    string                           `json:"committee_uid" jsonschema:"UID of the committee"`
	MemberUID       string                           `json:"member_uid" jsonschema:"UID of the member to update"`
	Email           *string                          `json:"email,omitempty" jsonschema:"Primary email address of the member"`
	AppointedBy     *string                          `json:"appointed_by,omitempty" jsonschema:"How the member was appointed"`
	Status          *string                          `json:"status,omitempty" jsonschema:"Member status"`
	FirstName       *string                          `json:"first_name,omitempty" jsonschema:"First name"`
	LastName        *string                          `json:"last_name,omitempty" jsonschema:"Last name"`
	JobTitle        *string                          `json:"job_title,omitempty" jsonschema:"Job title at organization"`
	LinkedinProfile *string                          `json:"linkedin_profile,omitempty" jsonschema:"LinkedIn profile URL"`
	Role            *CommitteeMemberRoleArgs         `json:"role,omitempty" jsonschema:"Committee role information"`
	Voting          *CommitteeMemberVotingArgs       `json:"voting,omitempty" jsonschema:"Voting information"`
	Organization    *CommitteeMemberOrganizationArgs `json:"organization,omitempty" jsonschema:"Organization information"`
}

UpdateCommitteeMemberArgs defines the input parameters for the update_committee_member tool. Only fields that are provided (non-nil) will be updated; omitted fields retain their current values (fetch-then-merge semantics).

type UpdateCommitteeSettingsArgs added in v0.3.0 

type UpdateCommitteeSettingsArgs struct {
	UID                   string  `json:"uid" jsonschema:"UID of the committee whose settings to update"`
	BusinessEmailRequired *bool   `json:"business_email_required,omitempty" jsonschema:"Whether business email is required for members"`
	MemberVisibility      *string `json:"member_visibility,omitempty" jsonschema:"Visibility level of member profiles to other members"`
	ShowMeetingAttendees  *bool   `json:"show_meeting_attendees,omitempty" jsonschema:"Whether to show meeting attendees by default"`
}

UpdateCommitteeSettingsArgs defines the input parameters for the update_committee_settings tool. Only fields that are provided (non-nil) will be updated; omitted fields retain their current values (fetch-then-merge semantics).

type UpdateMembershipKeyContactArgs added in v0.4.0 

type UpdateMembershipKeyContactArgs struct {
	ProjectUID     string  `json:"project_uid" jsonschema:"Project UUID"`
	MembershipUID  string  `json:"membership_uid" jsonschema:"Membership UID"`
	ContactUID     string  `json:"contact_uid" jsonschema:"Key contact UID"`
	Role           *string `json:"role,omitempty" jsonschema:"Contact role designation, e.g. 'Voting Representative'"`
	Status         *string `json:"status,omitempty" jsonschema:"Role record status, e.g. 'Active'"`
	BoardMember    *bool   `json:"board_member,omitempty" jsonschema:"Whether this contact holds a board member role"`
	PrimaryContact *bool   `json:"primary_contact,omitempty" jsonschema:"Whether this is the primary contact for the membership"`
}

UpdateMembershipKeyContactArgs defines the input parameters for the update_membership_key_contact tool. Only provided (non-nil) fields are updated; omitted fields retain their current values.

type UserInfoArgs 

type UserInfoArgs struct {
}

UserInfoArgs defines the input parameters for the user_info tool.

type UserInfoConfig 

type UserInfoConfig struct {
	UserInfoEndpoint string // Full userinfo endpoint URL (e.g., https://example.auth0.com/userinfo).
	HTTPClient       *http.Client
}

UserInfoConfig holds configuration for the user_info tool.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.