Apex SDK

Install the managed package using the provided Salesforce packaging link for your environment type (production or sandbox). This deploys the SDK base classes to your org.

# Install via Salesforce CLI (replace PACKAGE_VERSION_ID with the actual ID from the repo)
sf package install --package PACKAGE_VERSION_ID --target-org myorg --wait 10

Clone the repository and deploy the example server implementation from force-app/main/example/ to see a working MCP server before writing your own.

git clone https://github.com/bfmvsa/mcp-apex-sdk.git
cd mcp-apex-sdk
sf project deploy start --source-dir force-app/main/example --target-org myorg

In Salesforce Setup, navigate to Sites, create a new site, and set DemoServer as the active page. Then go to Public Access Settings and add DemoServer to Enabled Apex Class Access.

Your MCP server endpoint is constructed from your Site URL. For orgs without a namespace it is {site_url}/services/apexrest/mcp. For orgs with a namespace use {site_url}/services/apexrest/{namespace}/mcp.

Use the MCP Inspector browser tool to connect to your Salesforce-hosted endpoint and verify that tools, resources, and prompts are listed correctly.

npx @modelcontextprotocol/inspector

Extend the SDK classes to expose your own Salesforce data and business logic. Create Tool, Resource, and Prompt implementations, then register them with ctx.Server.

// Example Apex tool definition
public class MyTool extends ctx.Tool {
    public MyTool() {
        this.name = 'get_account';
        this.description = 'Retrieve a Salesforce Account by name';
    }
    public override Object call(Map<String, Object> args) {
        String name = (String) args.get('name');
        Account acc = [SELECT Id, Name, Industry FROM Account WHERE Name = :name LIMIT 1];
        return acc;
    }
}