MCP- N8N

Instructions

Implementation Reference

• src/index.ts:1329-1359 (handler)

  MCP tool handler for 'get-user': validates client, calls N8nClient.getUser(idOrEmail), and returns JSON response or error.

  case "get-user": {
    const { clientId, idOrEmail } = args as { clientId: string; idOrEmail: string };
    const client = clients.get(clientId);
    if (!client) {
      return {
        content: [{
          type: "text",
          text: "Client not initialized. Please run init-n8n first.",
        }],
        isError: true
      };
    }
  
    try {
      const user = await client.getUser(idOrEmail);
      return {
        content: [{
          type: "text",
          text: JSON.stringify(user, null, 2),
        }]
      };
    } catch (error) {
      return {
        content: [{
          type: "text",
          text: error instanceof Error ? error.message : "Unknown error occurred",
        }],
        isError: true
      };
    }
  }

• src/index.ts:592-602 (schema)

  Tool specification including name, description, and input schema in the ListTools response.

    name: "get-user",
    description: "Get user by ID or email address.",
    inputSchema: {
      type: "object",
      properties: {
        clientId: { type: "string" },
        idOrEmail: { type: "string" }
      },
      required: ["clientId", "idOrEmail"]
    }
  },

• src/index.ts:241-243 (helper)

  N8nClient method that performs the API request to fetch user by ID or email.

  async getUser(idOrEmail: string): Promise<N8nUser> {
    return this.makeRequest<N8nUser>(`/users/${idOrEmail}`);
  }

• src/index.ts:8-17 (schema)

  TypeScript interface defining the structure of a user object returned by the n8n API.

  interface N8nUser {
    id: string;
    email: string;
    firstName?: string;
    lastName?: string;
    isPending: boolean;
    role?: string;
    createdAt: string;
    updatedAt: string;
  }