Skip to content
Nappai Documentation

MCPServer

MCPServer is a component that lets you run and manage MCP tools inside the Nappai automation platform. It connects your workflow to the MCP toolset, allowing you to send commands and receive results without having to write code.

How it Works

When you add MCPServer to a workflow, it loads the MCP tool library that ships with Nappai. You give it a list of tools you want to use and any arguments you want to pass. The component then calls the appropriate MCP method, collects the output, and makes it available to the next steps in your workflow. All of this happens locally on the Nappai server, so there’s no need to reach out to external services.

Inputs

  • Tools: A list of MCP tools you want to run. Enter the tool names exactly as they appear in the MCP toolset.
  • args: A multiline text field where you can type any arguments or parameters that the selected tools need. Each line is treated as a separate argument.

Outputs

  • ToolResult: The raw result returned by the MCP tool you executed. This can be a string, a number, or a structured object depending on the tool.
  • ToolsConnected: A dictionary that lists all the tools that were successfully connected and ready for use. If no tools were connected, this output will be empty.

Usage Example

  1. Drag the MCPServer component onto your canvas.
  2. In the Tools field, type DataCleaner and ReportGenerator.
  3. In the args field, add the arguments you want to pass, one per line, e.g. 
    --input /data/raw
    --output /data/clean
  4. Connect the ToolResult output to a downstream component that will process the cleaned data.
  5. Run the workflow. The MCPServer will execute the tools, and you’ll see the results in the next component.
  • DataCleaner – A tool that removes duplicates and invalid entries from datasets.
  • ReportGenerator – A tool that creates PDF reports from cleaned data.

Tips and Best Practices

  • Keep the list of tools short; loading many tools at once can increase startup time.
  • Use the args field to pass tool‑specific flags; each line is treated as a separate argument.
  • Check the ToolsConnected output first to confirm that all required tools were loaded before proceeding.

Security Considerations

MCPServer runs entirely within the Nappai environment, so it does not expose any external network connections. However, be careful with the arguments you pass—avoid including sensitive data in plain text if the workflow is shared with others.