For the complete documentation index, see llms.txt. This page is also available as Markdown.

Getting Started

Get your first MCP server running in 5 minutes.

What You'll Build

A simple MCP server that exposes two tools: search and calculate. Clients can invoke these tools via the Model Context Protocol.

Step 1: Register Tools at Application Start

Create or edit your Application.bx to register tools when the application starts:

// Application.bx
class {

    function onApplicationStart() {
        // Get or create an MCP server instance
        MCPServer( "myApp" )
            .setDescription( "My Application MCP Server" )
            .setVersion( "1.0.0" )

            // Register first tool
            .registerTool(
                aiTool( "search", "Search for documents", ( query ) => {
                    return searchService.search( query )
                } )
            )

            // Register second tool
            .registerTool(
                aiTool( "calculate", "Perform calculations", ( expression ) => {
                    return evaluate( expression )
                } )
            )
    }

    function onApplicationEnd() {
        // Clean up on shutdown
        bxModules.bxai.models.mcp.MCPServer::removeInstance( "myApp" )
    }

}

Step 2: Access the MCP Endpoint

The module provides a built-in HTTP endpoint at public/mcp.bxm. Make a request specifying your server:

Or use URL segment:

Step 3: List Your Tools

Response:

Step 4: Invoke a Tool

Response:

What's Next?

Last updated