MCP by ServiceObjects - MCP Server

Our real-time services are the engine that leading businesses use to validate, correct and enhance global contact information.

This Model Context Protocol (MCP) python code sets up an MCP server and client with various APIs and operations from Service Objects. The client contains some sample code showing how the API can be called from code. But the purpose of this repos is for end users to pull the repo and add only the APIs they are testing or want access to.

For example, the following code adds to the MCP server seven different Service Objects APIs.

mcp = FastMCP()
register_av3_tools(mcp)
register_ev3_tools(mcp)
register_agus_tools(mcp)
register_gppl2_tools(mcp)
register_lvi_tools(mcp)
register_nv2_tools(mcp)
register_pvi_tools(mcp)

Keep only those you want to use. The underlying code that you can edit and customize for each Service Objects API is in the tools directory.

One of the most important files is the claude_desktop_config.json. In there, you set the license key or auth id need for the services you are using as well as a flag to indicate if you should be hitting the live API endpoints or the trial API endpoints. Only keep the keys and flags associated to the Service Objects API service you are using.

{
  "mcpServers": {
	"serviceobjects-mcp": {
      "command": "{UPDATE THIS TO YOUR PATH}\\python.exe",
      "args": ["{UPDATE THIS TO YOUR PATH}\\mcp_s.py"],
      "env": {
		"AV3Key": "YOUR AV3 LICENSE KEY",
		"EV3Key": "YOUR EV3 LICENSE KEY",
		"NV2Key": "YOUR NV2 LICENSE KEY",
		"AGUSKey": "YOUR AGUS LICENSE KEY",
		"LVIKey": "YOUR LVI LICENSE KEY",
		"GPPL2Key": "YOUR GPPL2 LICENSE KEY",
		"PVIAUTHID": "YOUR PVI AUTH ID",
		"IsAV3KeyLive": "True",
		"IsEV3KeyLive": "True",
		"IsNV2KeyLive": "True",
		"IsAGUSKeyLive": "True",
		"IsLVIKeyLive": "True",
		"IsGPPL2KeyLive": "True",
		"IsPVIAUTHIDLive": "True",
        "PYTHONUNBUFFERED": "1"
      }
    }
  }
}

But if you want to run the mcp_c.py from VS Code you can add the launch.json file with the following json to load up the same environment variables. These are the same detail as for the claude_desktop_config.json file. Do not update ${workspaceFolder} below, it will get populated on load.

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Service Objects MCP Server",
            "type": "debugpy",
            "request": "launch",
            "program": "${workspaceFolder}/mcp_s.py",
            "env": { "AV3Key": "YOUR AV3 LICENSE KEY",
                     "EV3Key": "YOUR EV3 LICENSE KEY",
                     "NV2Key": "YOUR NV2 LICENSE KEY",
                     "AGUSKey": "YOUR AGUS LICENSE KEY",
                     "LVIKey": "YOUR LVI LICENSE KEY",
                     "GPPL2Key": "YOUR GPPL2 LICENSE KEY",
                     "PVIAUTHID": "YOUR PVI AUTH ID",
                     "IsAV3KeyLive": "True",
                     "IsEV3KeyLive": "True",
                     "IsNV2KeyLive": "True",
                     "IsAGUSKeyLive": "True",
                     "IsLVIKeyLive": "True",
                     "IsGPPL2KeyLive": "True",
                     "IsPVIAUTHIDLive": "True", },
            "console": "integratedTerminal"
        }
    ]
}

ServiceObjects/MCP

Service Objects Website

Developer Guide/Documentation