AI-Powered Contact Management in KlickTipp with MCP Server

This n8n workflow demonstrates a foundational setup for AI-powered interactions using the Model Context Protocol (MCP) server, specifically highlighting the integration of a custom "Code Tool" within an AI agent's capabilities. While the provided JSON is a minimal example, it lays the groundwork for advanced contact management in platforms like KlickTipp by enabling an AI to execute custom logic.

What it does

This workflow serves as a template for building AI agents that can perform custom actions. Specifically, it:

1. Listens for AI Agent Requests: The MCP Server Trigger node acts as an entry point, waiting for requests from an AI agent that supports the Model Context Protocol. This trigger initiates the workflow when the AI agent decides to use one of its registered tools.
2. Provides a Custom Code Tool: The Code Tool node defines a custom function or action that the AI agent can invoke. In a real-world scenario, this tool would contain JavaScript code to interact with external services (e.g., KlickTipp API to add a contact, update a tag, or send an email), perform data manipulation, or execute complex business logic.
3. Illustrates AI Tooling: The presence of both the MCP Server Trigger and Code Tool signifies an architecture where an AI agent can dynamically decide to execute custom code based on its understanding of a user's request.

Prerequisites/Requirements

• n8n Instance: A running instance of n8n (self-hosted or cloud).
• Model Context Protocol (MCP) Server: An AI agent or service configured to communicate via the Model Context Protocol, capable of invoking tools registered with an MCP server.
• Understanding of JavaScript: To customize the Code Tool node for specific actions.

Setup/Usage

1. Import the Workflow:
   • Copy the provided JSON code.
   • In your n8n instance, go to "Workflows" and click "New".
   • Click the "..." menu in the top right and select "Import from JSON".
   • Paste the JSON and click "Import".
2. Configure the MCP Server Trigger:
   • The MCP Server Trigger node will automatically configure itself. Its primary purpose is to act as a listener for an AI agent.
3. Customize the Code Tool:
   • Open the Code Tool node.
   • Replace the placeholder code with your desired JavaScript logic. For example, you could write code to:
     • Call the KlickTipp API to create a new contact.
     • Update an existing contact's tags or custom fields.
     • Send a specific email campaign.
     • Retrieve contact information based on AI agent queries.
   • Ensure the Code Tool returns a meaningful response that the AI agent can interpret.
4. Connect to an AI Agent:
   • Configure your AI agent (e.g., a custom GPT, a LangChain application, or another AI service) to use an MCP server and register this n8n workflow's Code Tool as an available action. The AI agent will then be able to call this tool when appropriate.
5. Activate the Workflow:
   • Once configured, activate the workflow by toggling the "Active" switch in the top right corner of the n8n editor.

This workflow provides a powerful foundation for integrating custom business logic and third-party API interactions into your AI agents, enabling them to perform specific, tailored actions in response to user prompts.