LFX MCP Server

May 5, 2026 · View on GitHub

A Model Context Protocol (MCP) server that connects AI assistants to the Linux Foundation's LFX platform.

What You Can Do

Explore projects — Search and retrieve details for any LFX project
Manage committees — Search, create, update, and delete committees and their members across projects
Work with mailing lists — Search mailing lists and their subscribers
Query members — Search memberships by tier, status, organization, and more; get and manage key contacts
Track meetings — Find upcoming meetings, registrants, past participants, and AI-generated summaries
Manage Discord roles — List roles, find users, check and assign roles in a project's Discord guild
Send emails — Browse email templates and send templated emails via LFX mail servers
Query with LFX Lens — Ask natural-language questions about project data (events, contributors, health, and more)
Search B2B organizations — Find organizations and list their project memberships

Connecting to the LFX MCP Server

The LFX MCP Server is available as a hosted, production service at:

https://mcp.lfx.dev/mcp

This endpoint uses the Streamable HTTP transport with OAuth 2.0 authentication. You will be prompted to log in with your Linux Foundation account the first time you connect.

Note: Running the LFX MCP Server locally (e.g. in stdio mode) is not a supported end-user configuration. The full tool set requires OAuth authentication flows that are only available through the hosted service.

Linux Foundation SSO does not support Dynamic Client Registration (DCR) or Client ID Metadata Documents (CIMD) at this time. Please file an issue to request additional client support.

OpenCode

Add the following to your ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "lfx-mcp-server": {
      "type": "remote",
      "url": "https://mcp.lfx.dev/mcp",
      "enabled": true,
      "oauth": {
        "clientId": "LnBd9qGpwjXNs26aZxeXSkTCs0ac4zgM"
      }
    }
  }
}

See the OpenCode MCP documentation for more details.

Claude (LF enterprise)

If you use the Linux Foundation's enterprise Claude.ai organization, the LFX MCP Server is already provisioned as a connector — you do not need to add it manually.

In Claude.ai, open Settings → Connectors.
Find LFX MCP Server in the list of available connectors.
Click Connect.
Sign in with your LFID when prompted.
Click Authorize to grant access; you will be redirected back to Claude.

The connector is now active for your account.

Claude (personal account)

Add the LFX MCP Server in **Settings → Connectors → Add Custom Connector **:

URL: https://mcp.lfx.dev/mcp
Client ID: Ef9tuU5wcJJIXmNGvZyGUkZFfD8CZWar

Cursor

Add the following to your ~/.cursor/mcp.json:

{
  "mcpServers": {
    "lfx": {
      "url": "https://mcp.lfx.dev/mcp",
      "auth": {
        "CLIENT_ID": "HwGWwUy4uvqVQYDsuXb9IVamzcUhdZj5"
      }
    }
  }
}

Additional clients (via mcp-remote)

If your MCP client does not support OAuth 2.0 with Streamable HTTP, you can use mcp-remote as a local proxy. It handles the OAuth flow in your browser and serves a stdio transport to your MCP client.

The port 3334 is required so that the OAuth callback URL matches the registered client. Please refer to your client's documentation for the exact configuration syntax. For example, in Zed (~/.config/zed/settings.json):

{
  "context_servers": {
    "lfx": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.lfx.dev/mcp",
        "3334",
        "--static-oauth-client-info",
        "{\"client_id\":\"tjrXD5ZJORf6rpngMSRqqPmf3W1bnHEV\"}"
      ]
    }
  }
}

A browser window will open for authentication on first use. To clear cached credentials (e.g. to re-authenticate):

rm -rf ~/.mcp-auth

MCP Inspector (developer testing)

MCP Inspector is a browser-based tool for exploring and testing MCP servers. To connect it to the LFX MCP Server:

npx @modelcontextprotocol/inspector

Then in the Inspector UI:

Transport: Streamable HTTP
URL: https://mcp.lfx.dev/mcp
Authentication → OAuth 2.0 Flow → Client ID: 4ibLLbnz9kwMEcE3RUCUH51F0RS3Hx3O

Before hitting Connect, follow the Open Auth Settings button, then select Quick OAuth Flow.

Available Tools

Projects

Tool	Description
`search_projects`	Search for LFX projects by name with typeahead and pagination
`get_project`	Get a project's base info and settings by UID

Committees

Tool	Description
`search_committees`	Search for committees by name; optionally filter by project
`get_committee`	Get a committee's base info and settings by UID
`create_committee`	Create a new committee under a project
`update_committee`	Update a committee's base information
`update_committee_settings`	Update a committee's settings (visibility, email requirements, meeting attendee defaults)
`delete_committee`	Delete a committee by UID
`search_committee_members`	Search committee members; filter by committee, project, or name
`get_committee_member`	Get a specific committee member by committee and member UID
`create_committee_member`	Add a new member to a committee
`update_committee_member`	Update an existing committee member's information
`delete_committee_member`	Remove a member from a committee

Mailing Lists

Tool	Description
`search_mailing_lists`	Search for mailing lists by name; optionally filter by project
`get_mailing_list`	Get a mailing list's base info and settings by UID
`get_mailing_list_service`	Get a mailing list service's base info and settings by UID
`search_mailing_list_members`	Search mailing list members; filter by list, project, or name
`get_mailing_list_member`	Get a specific mailing list member by list and member UID

Members

Tool	Description
`search_members`	Search and filter members (memberships) by status, tier, organization, and more
`get_member_membership`	Get a single member's membership details by member and membership ID
`list_project_tiers`	List all membership tiers (e.g. Gold, Silver, Bronze) defined for a project
`get_project_tier`	Get a single membership tier by project and tier UID
`get_membership_key_contacts`	Get key contacts (primary contacts, board members) for a membership
`get_membership_key_contact`	Get a single key contact by project, membership, and contact UID
`create_membership_key_contact`	Add a key contact to a membership
`update_membership_key_contact`	Update an existing key contact on a membership
`delete_membership_key_contact`	Remove a key contact from a membership

Meetings

Tool	Description
`search_meetings`	Search for meetings; filter by project, committee, date range
`get_meeting`	Get a meeting by UID
`search_meeting_registrants`	Search meeting registrants; filter by meeting, committee, project
`get_meeting_registrant`	Get a meeting registrant by UID

Past Meeting Data

Tool	Description
`search_past_meetings`	Search past meetings; filter by project, committee, date range
`get_past_meeting`	Get a past meeting by UID
`search_past_meeting_participants`	Search past meeting participants; filter by meeting, committee, project
`get_past_meeting_participant`	Get a past meeting participant by UID
`search_past_meeting_summaries`	Search past meeting summaries; filter by meeting, committee, project
`get_past_meeting_summary`	Get a past meeting summary by UID

Discord

Tool	Description
`list_discord_roles`	List all roles in a project's Discord guild
`find_discord_role`	Find a Discord role by name
`find_discord_user`	Find a Discord guild member by name and optional email
`check_discord_user_role`	Check whether a Discord user already has a specific role
`assign_discord_role`	Assign a Discord role to a user

Email

Tool	Description
`list_email_templates`	List all available email templates for a project
`send_email`	Send a templated email via LFX mail servers

LFX Lens

Tool	Description
`query_lfx_lens`	Ask natural-language questions about a project's data (events, contributors, health, value, and more)

B2B Organizations

Tool	Description
`search_b2b_orgs`	Search and list B2B organizations
`list_b2b_org_memberships`	List all project memberships for a B2B organization

Utility

Tool	Description
`hello_world`	Simple greeting tool for testing MCP connectivity
`user_info`	Get the authenticated user's OpenID Connect profile

License

This project's source code is licensed under the MIT License. A copy of the license is available in LICENSE.

This project's documentation is licensed under the Creative Commons Attribution 4.0 International License (CC-BY-4.0). A copy of the license is available in LICENSE-docs.